API Reference
Search policies
Search and list coverage policies with filtering and pagination.
Authorization
bearerAuth AuthorizationBearer <token>
API key in format: vrt_live_xxxxx or vrt_test_xxxxx
In: header
Query Parameters
q?string
Search query (keyword search)
Length
length <= 500mode?string
Search mode
Default
"keyword"Value in
"keyword" | "semantic"policy_type?string
Filter by policy type
Value in
"LCD" | "Article" | "NCD" | "PayerPolicy" | "Medical Policy" | "Drug Policy"jurisdiction?string
Filter by MAC jurisdiction code (e.g., JE, JF)
Length
length <= 10payer?string
Filter by payer name (partial match)
Length
length <= 50status?string
Filter by policy status
Default
"active"Value in
"active" | "retired" | "all"cursor?string
Pagination cursor from previous response
limit?integer
Results per page
Default
50Range
1 <= value <= 100include?string
Additional data to include (comma-separated: summary, criteria, codes)
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://verity.backworkai.com/api/v1/policies"{
"success": true,
"data": [
{
"policy_id": "string",
"title": "string",
"policy_type": "LCD",
"jurisdiction": "string",
"effective_date": "2019-08-24",
"retire_date": "2019-08-24",
"status": "active",
"source_url": "http://example.com",
"payer": "string",
"summary": "string",
"codes": [
{
"code": "string",
"code_system": "string",
"disposition": "string"
}
],
"code_count": 0
}
],
"meta": {
"request_id": "string",
"timestamp": "2019-08-24T14:15:22Z",
"pagination": {
"cursor": "string",
"has_more": true,
"limit": 0
},
"search": {
"query": "string",
"mode": "string"
},
"filters": {}
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"details": {
"q": [
"Search query is required"
]
},
"docUrl": "https://docs.verity.io/errors#validation-error"
},
"meta": {
"request_id": "req_abc123",
"timestamp": "2024-01-15T10:30:00Z"
}
}{
"success": false,
"error": {
"code": "AUTH_KEY_NOT_FOUND",
"message": "API key not found",
"hint": "Check that your API key is correct",
"docUrl": "https://docs.verity.io/errors#auth-key-not-found"
},
"meta": {
"request_id": "req_abc123",
"timestamp": "2024-01-15T10:30:00Z"
}
}{
"success": false,
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Rate limit exceeded",
"hint": "Upgrade to pay-as-you-go for higher limits",
"docUrl": "https://docs.verity.io/errors#rate-limit-exceeded"
},
"meta": {
"request_id": "req_abc123",
"timestamp": "2024-01-15T10:30:00Z"
}
}