Search policies

Search and list coverage policies with filtering and pagination.

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

q?string

Search query (max 500 characters)

Lengthlength <= 500

mode?string

Search mode

Default"keyword"

Value in"keyword" | "semantic"

policy_type?string

Filter by policy type

jurisdiction?string

Filter by MAC jurisdiction code

Lengthlength <= 10

payer?string

Filter by payer name. Supported in both keyword and semantic search modes.

Lengthlength <= 50

icd10?string

Filter by ICD-10 code. Returns policies that cover this diagnosis code.

Lengthlength <= 10

_format?string

FHIR-standard output format parameter. When set, overrides the default JSON envelope and returns FHIR R4 resources directly. Supports: json (FHIR JSON), application/fhir+json. Use format=csv or format=fhir as convenience aliases.

Value in"json" | "application/fhir+json"

format?string

Output format. json (default Verity envelope), csv (CSV download), fhir (FHIR R4). When format=fhir, the response is a FHIR R4 Bundle of CoverageEligibilityResponse resources including servicedDate populated from each policy's effective_date. When format=csv, the response always includes a header row, even with zero results.

Default"json"

Value in"json" | "csv" | "fhir"

status?string

Filter by status

Default"active"

Value in"active" | "retired" | "all"

cursor?string

Pagination cursor (base64url encoded)

limit?integer

Results per page

Default50

Range1 <= value <= 100

include?string

Additional data to include (comma-separated)

Response Body

`application/json`

curl -X GET "https://verity.backworkai.com/api/v1/policies?q=ultrasound+guidance&icd10=E11.9&include=summary%2Ccriteria%2Ccodes"

{
  "success": true,
  "data": [
    {
      "policy_id": "L33831",
      "title": "Ultrasound Guidance for Needle Placement",
      "policy_type": "LCD",
      "jurisdiction": "JM",
      "effective_date": "2019-08-24",
      "retire_date": "2019-08-24",
      "status": "active",
      "source_url": "string",
      "summary": "string",
      "codes": [
        {
          "code": "string",
          "code_system": "string",
          "disposition": "string"
        }
      ],
      "code_count": 0,
      "criteria": [
        {
          "section": "string",
          "text": "string",
          "tags": [
            "string"
          ]
        }
      ]
    }
  ],
  "meta": {
    "pagination": {
      "cursor": "eyJpZCI6MTIzfQ",
      "has_more": true,
      "limit": 50
    },
    "search": {
      "query": "string",
      "mode": "string"
    },
    "filters": {
      "policy_type": "string",
      "jurisdiction": "string",
      "status": "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"
  }
}

Search policies

Authorization

Query Parameters

Response Body

200

400application/json

401application/json

429application/json

`application/json`

`application/json`

`application/json`