API Reference
Research prior authorization requirements
Use AI-powered web research to find prior authorization requirements directly from payer websites. Supports async mode with polling or synchronous mode. Returns structured findings including determination, documentation requirements, and source URLs.
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"
}
}