curl --request POST \
--url https://api.sandbox.trycollate.ai/v1/prior-auth/authorizations/{authorizationId}/cancel \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"reason": "Submitted in error"
}
'{
"id": "auth_123",
"workflowState": "cancelled",
"decisionState": "unknown",
"urgency": "standard",
"submissionChannel": null,
"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": [],
"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:25:00.000Z",
"submittedAt": null,
"completedAt": "2026-03-13T17:25:00.000Z"
}Cancels an authorization.
curl --request POST \
--url https://api.sandbox.trycollate.ai/v1/prior-auth/authorizations/{authorizationId}/cancel \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"reason": "Submitted in error"
}
'{
"id": "auth_123",
"workflowState": "cancelled",
"decisionState": "unknown",
"urgency": "standard",
"submissionChannel": null,
"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": [],
"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:25:00.000Z",
"submittedAt": null,
"completedAt": "2026-03-13T17:25:00.000Z"
}Bearer token for WorkOS session JWTs and organization API keys.
"auth_123"
Cancelled 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