API Reference
Evaluate coverage criteria
Evaluate a policy's structured coverage criteria against patient/claim parameters. Returns coverage determination with confidence score and detailed reasons.
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
policy_id*string
The policy identifier
parameters*
Patient/claim parameters to evaluate against criteria
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://verity.backworkai.com/api/v1/coverage/evaluate" \ -H "Content-Type: application/json" \ -d '{ "policy_id": "L33831", "parameters": {} }'{
"success": true,
"data": {
"covered": true,
"confidence": 0.85,
"reasons": [
"string"
],
"matched_criteria": [
"string"
],
"unmatched_criteria": [
"string"
],
"skipped_criteria": [
"string"
],
"blocks_evaluated": 0,
"blocks_without_ast": 0,
"policy": {
"policy_id": "string",
"title": "string",
"policy_type": "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"
}
}{
"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"
}
}