VerityVerity API
API Reference

Search coverage criteria

Search through coverage criteria blocks (indications, limitations, documentation requirements).

GET
/coverage/criteria

Authorization

bearerAuth
AuthorizationBearer <token>

API key in format: vrt_live_xxxxx or vrt_test_xxxxx

In: header

Query Parameters

q*string

Search query

Length1 <= length <= 500
section?string

Filter by criteria section

Value in"indications" | "limitations" | "documentation" | "frequency" | "other"
policy_type?string

Filter by policy type

Value in"LCD" | "Article" | "NCD" | "PayerPolicy"
jurisdiction?string

Filter by MAC jurisdiction

Lengthlength <= 10
cursor?string

Pagination cursor from previous response

limit?integer

Results per page

Default50
Range1 <= value <= 100

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://verity.backworkai.com/api/v1/coverage/criteria?q=string"
{
  "success": true,
  "data": [
    {
      "criteria_id": "string",
      "section": "indications",
      "text": "string",
      "tags": [
        "string"
      ],
      "requires_manual_review": true,
      "confidence_score": 0,
      "policy": {
        "policy_id": "string",
        "title": "string",
        "policy_type": "string",
        "jurisdiction": "string",
        "effective_date": "2019-08-24"
      }
    }
  ],
  "meta": {
    "request_id": "string",
    "timestamp": "2019-08-24T14:15:22Z",
    "pagination": {
      "cursor": "string",
      "has_more": true,
      "limit": 0
    },
    "search": {
      "query": "string",
      "section": "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"
  }
}