curl --request POST \
--url https://api.sandbox.trycollate.ai/v1/prior-auth/authorizations/{authorizationId}/submit \
--header 'Authorization: Bearer <token>'{
"id": "auth_123",
"workflowState": "pending_payer",
"decisionState": "pending",
"urgency": "standard",
"submissionChannel": "fax",
"payer": {
"id": "payer_aetna",
"slug": "aetna",
"displayName": "Aetna"
},
"patient": {
"identifiers": [
{
"type": "mrn",
"value": "MRN-001"
}
],
"firstName": "Jane",
"lastName": "Doe",
"dateOfBirth": "1988-05-09",
"gender": "female",
"phone": "415-555-0100",
"address": {
"line1": "123 Main St",
"city": "San Francisco",
"state": "CA",
"zip": "94105"
}
},
"coverage": {
"payerId": "payer_aetna",
"memberId": "W123456789",
"groupNumber": "GRP-123",
"planType": "commercial",
"insuranceState": "CA"
},
"providers": [
{
"role": "prescribing",
"identifiers": [
{
"type": "npi",
"value": "1234567890"
}
],
"firstName": "Ajay",
"lastName": "Patel",
"specialty": "hematologist",
"phone": "415-555-0100",
"fax": "415-555-0101",
"address": {
"line1": "100 Main St",
"city": "San Francisco",
"state": "CA",
"zip": "94105"
}
}
],
"service": {
"code": "J0791",
"codeSystem": "hcpcs",
"drugName": "Adakveo",
"requestedStartDate": "2026-03-13",
"requestedEndDate": "2026-09-13"
},
"diagnoses": [
{
"code": "D57.00",
"codeSystem": "icd_10"
}
],
"locations": null,
"requestedBy": {
"firstName": "Alicia",
"lastName": "Gomez",
"phone": "415-555-0100"
},
"siteOfCare": null,
"treatmentPhase": null,
"questionnaire": {
"resourceType": "Questionnaire",
"url": "https://api.example.com/questionnaires/aetna-adakveo-precert-2026-01",
"title": "Adakveo Medication Precertification Request",
"status": "active",
"item": [
{
"linkId": "request",
"text": "Request details",
"type": "group",
"item": [
{
"linkId": "request_type",
"text": "Request type",
"type": "choice",
"required": true,
"answerOption": [
{
"valueCoding": {
"code": "start_of_treatment",
"display": "Start of treatment"
}
}
]
},
{
"linkId": "acknowledgment_date",
"text": "Acknowledgment date",
"type": "date",
"required": true
}
]
}
]
},
"questionnaireResponse": {
"resourceType": "QuestionnaireResponse",
"questionnaire": "https://api.example.com/questionnaires/aetna-adakveo-precert-2026-01",
"status": "completed",
"item": [
{
"linkId": "request_type",
"answer": [
{
"valueCoding": {
"code": "start_of_treatment",
"display": "Start of treatment"
}
}
]
},
{
"linkId": "acknowledgment_date",
"answer": [
{
"valueDate": "2026-03-13"
}
]
}
]
},
"paRequired": true,
"recommendedChannel": "fax",
"availableChannels": [
"fax"
],
"supportingDocumentationGuidance": [
"Recent hematology note describing the diagnosis and treatment plan.",
"Utilization summary documenting vaso-occlusive crises in the last 12 months."
],
"sourceForm": {
"formId": "aetna-adakveo-precert-2026-01",
"title": "Adakveo Medication Precertification Request",
"formDocumentUrl": "https://cdn.example.com/forms/aetna-adakveo-precert-2026-01.pdf",
"pageCount": 2
},
"provenance": {
"sourceFormId": "aetna-adakveo-precert-2026-01",
"sourceName": "Adakveo Medication Precertification Request",
"effectiveDate": "2026-01-12T15:23:46.000Z"
},
"templateVersion": "2026-01",
"lastVerifiedAt": "2026-01-12T15:23:46.000Z",
"expiresAt": null,
"attachments": [
{
"id": "att_123",
"authorizationId": "auth_123",
"fileId": "file_123",
"label": "Recent clinical note",
"mimeType": "application/pdf",
"sizeBytes": 48213,
"downloadUrl": "https://cdn.example.com/files/authorization_attachment/file_123/clinical-note.pdf",
"createdAt": "2026-03-13T17:12:00.000Z"
}
],
"actions": [],
"decisionDetails": {
"certificationNumber": null,
"payerReferenceNumber": null,
"denialReasonCode": null,
"denialReasonMessage": null,
"approvedStartDate": null,
"approvedEndDate": null,
"approvalExpiresAt": null
},
"validationIssues": [],
"contextRequirements": [
{
"key": "context.providers.prescribing",
"label": "Prescribing provider",
"requiredMode": "required",
"status": "satisfied",
"blocking": true,
"paths": [
"providers[role=prescribing].firstName",
"providers[role=prescribing].lastName",
"providers[role=prescribing].identifiers[npi]"
],
"message": "Prescribing provider is required for this payer form."
}
],
"questionStates": [
{
"key": "questionnaire.request_type",
"linkId": "request_type",
"enabled": true,
"required": true,
"answered": true,
"blocking": false
},
{
"key": "questionnaire.acknowledgment_date",
"linkId": "acknowledgment_date",
"enabled": true,
"required": true,
"answered": true,
"blocking": false
}
],
"activeRequirementGroups": [],
"supportingDocumentRequests": [
{
"key": "questionnaire.request_type",
"label": "Clinical documentation",
"requiredMode": "recommended",
"status": "recommended",
"likelyDocTypes": [
"clinical_note",
"treatment_plan"
],
"message": "Clinical documentation is commonly included with this request."
}
],
"createdAt": "2026-03-13T17:00:00.000Z",
"updatedAt": "2026-03-13T17:15:00.000Z",
"submittedAt": "2026-03-13T17:15:00.000Z",
"completedAt": null
}Validates and submits an authorization through the platform’s selected submission rail.
curl --request POST \
--url https://api.sandbox.trycollate.ai/v1/prior-auth/authorizations/{authorizationId}/submit \
--header 'Authorization: Bearer <token>'{
"id": "auth_123",
"workflowState": "pending_payer",
"decisionState": "pending",
"urgency": "standard",
"submissionChannel": "fax",
"payer": {
"id": "payer_aetna",
"slug": "aetna",
"displayName": "Aetna"
},
"patient": {
"identifiers": [
{
"type": "mrn",
"value": "MRN-001"
}
],
"firstName": "Jane",
"lastName": "Doe",
"dateOfBirth": "1988-05-09",
"gender": "female",
"phone": "415-555-0100",
"address": {
"line1": "123 Main St",
"city": "San Francisco",
"state": "CA",
"zip": "94105"
}
},
"coverage": {
"payerId": "payer_aetna",
"memberId": "W123456789",
"groupNumber": "GRP-123",
"planType": "commercial",
"insuranceState": "CA"
},
"providers": [
{
"role": "prescribing",
"identifiers": [
{
"type": "npi",
"value": "1234567890"
}
],
"firstName": "Ajay",
"lastName": "Patel",
"specialty": "hematologist",
"phone": "415-555-0100",
"fax": "415-555-0101",
"address": {
"line1": "100 Main St",
"city": "San Francisco",
"state": "CA",
"zip": "94105"
}
}
],
"service": {
"code": "J0791",
"codeSystem": "hcpcs",
"drugName": "Adakveo",
"requestedStartDate": "2026-03-13",
"requestedEndDate": "2026-09-13"
},
"diagnoses": [
{
"code": "D57.00",
"codeSystem": "icd_10"
}
],
"locations": null,
"requestedBy": {
"firstName": "Alicia",
"lastName": "Gomez",
"phone": "415-555-0100"
},
"siteOfCare": null,
"treatmentPhase": null,
"questionnaire": {
"resourceType": "Questionnaire",
"url": "https://api.example.com/questionnaires/aetna-adakveo-precert-2026-01",
"title": "Adakveo Medication Precertification Request",
"status": "active",
"item": [
{
"linkId": "request",
"text": "Request details",
"type": "group",
"item": [
{
"linkId": "request_type",
"text": "Request type",
"type": "choice",
"required": true,
"answerOption": [
{
"valueCoding": {
"code": "start_of_treatment",
"display": "Start of treatment"
}
}
]
},
{
"linkId": "acknowledgment_date",
"text": "Acknowledgment date",
"type": "date",
"required": true
}
]
}
]
},
"questionnaireResponse": {
"resourceType": "QuestionnaireResponse",
"questionnaire": "https://api.example.com/questionnaires/aetna-adakveo-precert-2026-01",
"status": "completed",
"item": [
{
"linkId": "request_type",
"answer": [
{
"valueCoding": {
"code": "start_of_treatment",
"display": "Start of treatment"
}
}
]
},
{
"linkId": "acknowledgment_date",
"answer": [
{
"valueDate": "2026-03-13"
}
]
}
]
},
"paRequired": true,
"recommendedChannel": "fax",
"availableChannels": [
"fax"
],
"supportingDocumentationGuidance": [
"Recent hematology note describing the diagnosis and treatment plan.",
"Utilization summary documenting vaso-occlusive crises in the last 12 months."
],
"sourceForm": {
"formId": "aetna-adakveo-precert-2026-01",
"title": "Adakveo Medication Precertification Request",
"formDocumentUrl": "https://cdn.example.com/forms/aetna-adakveo-precert-2026-01.pdf",
"pageCount": 2
},
"provenance": {
"sourceFormId": "aetna-adakveo-precert-2026-01",
"sourceName": "Adakveo Medication Precertification Request",
"effectiveDate": "2026-01-12T15:23:46.000Z"
},
"templateVersion": "2026-01",
"lastVerifiedAt": "2026-01-12T15:23:46.000Z",
"expiresAt": null,
"attachments": [
{
"id": "att_123",
"authorizationId": "auth_123",
"fileId": "file_123",
"label": "Recent clinical note",
"mimeType": "application/pdf",
"sizeBytes": 48213,
"downloadUrl": "https://cdn.example.com/files/authorization_attachment/file_123/clinical-note.pdf",
"createdAt": "2026-03-13T17:12:00.000Z"
}
],
"actions": [],
"decisionDetails": {
"certificationNumber": null,
"payerReferenceNumber": null,
"denialReasonCode": null,
"denialReasonMessage": null,
"approvedStartDate": null,
"approvedEndDate": null,
"approvalExpiresAt": null
},
"validationIssues": [],
"contextRequirements": [
{
"key": "context.providers.prescribing",
"label": "Prescribing provider",
"requiredMode": "required",
"status": "satisfied",
"blocking": true,
"paths": [
"providers[role=prescribing].firstName",
"providers[role=prescribing].lastName",
"providers[role=prescribing].identifiers[npi]"
],
"message": "Prescribing provider is required for this payer form."
}
],
"questionStates": [
{
"key": "questionnaire.request_type",
"linkId": "request_type",
"enabled": true,
"required": true,
"answered": true,
"blocking": false
},
{
"key": "questionnaire.acknowledgment_date",
"linkId": "acknowledgment_date",
"enabled": true,
"required": true,
"answered": true,
"blocking": false
}
],
"activeRequirementGroups": [],
"supportingDocumentRequests": [
{
"key": "questionnaire.request_type",
"label": "Clinical documentation",
"requiredMode": "recommended",
"status": "recommended",
"likelyDocTypes": [
"clinical_note",
"treatment_plan"
],
"message": "Clinical documentation is commonly included with this request."
}
],
"createdAt": "2026-03-13T17:00:00.000Z",
"updatedAt": "2026-03-13T17:15:00.000Z",
"submittedAt": "2026-03-13T17:15:00.000Z",
"completedAt": null
}Bearer token for WorkOS session JWTs and organization API keys.
8 - 128"create-auth-001"
"auth_123"
Submitted authorization.
needs_input, ready_to_submit, submitting, pending_payer, action_required, completed, cancelled unknown, pending, approved, denied standard, urgent, retrospective fax, portal, phone, null Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
initiation, continuation, null Show child attributes
Show child attributes
fax, portal, phone, null fax, portal, phone, null Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes