API Reference
Get prior authorization research status
Poll the status and results of a prior authorization research task. Returns the current status, and when completed, the full structured research results including determination, documentation requirements, and sources.
Authorization
bearerAuth AuthorizationBearer <token>
API keys are prefixed with vrt_live_ for production or vrt_test_ for testing.
Example: vrt_live_abc123xyz
In: header
Path Parameters
id*string
Research task ID returned from POST /prior-auth/research
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://verity.backworkai.com/api/v1/prior-auth/research/res_abc123"{
"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"
}
}