API Reference
Get Medicaid spending by code
Returns aggregate Medicaid provider spending statistics per HCPCS code, including totals and year-over-year breakdowns from CMS claims data.
Authorization
bearerAuth AuthorizationBearer <token>
API keys are prefixed with vrt_live_ for production or vrt_test_ for testing.
Example: vrt_live_abc123xyz
In: header
Query Parameters
code?string
Single HCPCS code to look up
Length
1 <= length <= 10codes?string
Comma-separated list of HCPCS codes (max 10)
Length
length <= 100year?integer
Filter to a specific year
Range
2000 <= value <= 2100Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://verity.backworkai.com/api/v1/spending/by-code?code=T1019&codes=T1019%2CT1020&year=2023"{
"success": true,
"data": {
"property1": {
"total_paid": "1234567.89",
"total_claims": 50000,
"unique_beneficiaries": 25000,
"unique_providers": 1200,
"date_range": {
"min": "string",
"max": "string"
},
"by_year": [
{
"year": 2023,
"total_paid": "string",
"total_claims": 0,
"unique_beneficiaries": 0
}
]
},
"property2": {
"total_paid": "1234567.89",
"total_claims": 50000,
"unique_beneficiaries": 25000,
"unique_providers": 1200,
"date_range": {
"min": "string",
"max": "string"
},
"by_year": [
{
"year": 2023,
"total_paid": "string",
"total_claims": 0,
"unique_beneficiaries": 0
}
]
}
},
"meta": {
"codes_requested": 0,
"year_filter": 0
}
}{
"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"
}
}