API Reference
Research prior authorization requirements
Use AI-powered web research to find prior authorization requirements directly from payer websites. Supports async mode (returns research_id for polling) or synchronous mode (waits for completion). Cost: 5 billable units per request.
Authorization
bearerAuth AuthorizationBearer <token>
API keys are prefixed with vrt_live_ for production or vrt_test_ for testing.
Example: vrt_live_abc123xyz
In: header
Request Body
application/json
procedure_codes*array<>
CPT/HCPCS codes to research
Items
1 <= items <= 10payer?string
Specific payer name (e.g., "UnitedHealthcare", "Aetna")
state?string
Two-letter state code for jurisdiction-specific policies
Length
2 <= length <= 2diagnosis_codes?array<>
ICD-10 diagnosis codes for clinical context
clinical_context?string
Additional clinical notes
Length
length <= 2000sync?boolean
If true, wait for completion. If false, return research_id for polling.
Default
falseResponse Body
application/json
application/json
application/json
application/json
curl -X POST "https://verity.backworkai.com/api/v1/prior-auth/research" \ -H "Content-Type: application/json" \ -d '{ "procedure_codes": [ "27447" ] }'{
"success": true,
"data": {
"research_id": "res_abc123",
"status": "pending",
"created_at": "2019-08-24T14:15:22Z",
"finished_at": "2019-08-24T14:15:22Z",
"poll_url": "/api/v1/prior-auth/research/res_abc123",
"result": {
"determination": {
"pa_required": true,
"confidence": "string",
"reasoning": "string"
},
"payer_policies": [
{
"title": "string",
"url": "string",
"summary": "string"
}
],
"documentation_requirements": [
"string"
],
"medical_necessity_criteria": [
"string"
],
"coverage_limitations": [
"string"
],
"timeline": "string",
"appeal_process": "string",
"sources": [
"string"
]
},
"cost": {
"num_searches": 0,
"num_pages": 0,
"reasoning_tokens": 0,
"total_dollars": 0.1
},
"error": "string"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid query parameters",
"hint": "Check the 'code' parameter format",
"details": {}
},
"meta": {
"request_id": "req_abc123"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid query parameters",
"hint": "Check the 'code' parameter format",
"details": {}
},
"meta": {
"request_id": "req_abc123"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid query parameters",
"hint": "Check the 'code' parameter format",
"details": {}
},
"meta": {
"request_id": "req_abc123"
}
}Last updated on