Quickstart

Verity gives you instant access to 19,000+ Medicare coverage policies as structured, searchable data.

What Verity does

Medicare coverage policies are scattered across thousands of PDFs from different contractors. Finding them means digging through payer portals, reading dense policy documents, and manually tracking changes.

Verity solves this. We extract coverage criteria, prior auth requirements, and code coverage from LCDs, Articles, and NCDs. You get clean JSON instead of unstructured PDFs.

Installation

We built SDKs for the languages developers actually use:

pip install verity-python

npm install verity-api

# Download binary - no runtime needed
go install github.com/tylerbryy/verity-cli@latest

dotnet add package Verity.SDK

Get your API key from the Developer Console.

Your first request

from verity import VerityClient

client = VerityClient(api_key="vrt_live_YOUR_API_KEY")

# Look up a code with RVU data and policies
result = client.lookup_code(code="76942", include=["rvu", "policies"])

print(result["data"]["description"])
# "Echo guide for biopsy"

print(f"Facility price: ${result['data']['rvu']['facility_price']}")
# "Facility price: $64.13"

print(f"Found {len(result['data']['policies'])} coverage policies")
# "Found 16 coverage policies"

import { VerityClient } from 'verity-api';

const client = new VerityClient('vrt_live_YOUR_API_KEY');

// Look up a code with RVU data and policies
const result = await client.lookupCode({
  code: '76942',
  include: ['rvu', 'policies']
});

console.log(result.data.description);
// "Echo guide for biopsy"

console.log(`Facility price: $${result.data.rvu?.facility_price}`);
// "Facility price: $64.13"

console.log(`Found ${result.data.policies?.length} coverage policies`);
// "Found 16 coverage policies"

export VERITY_API_KEY=vrt_live_YOUR_API_KEY

# Look up a code with RVU data and policies
verity check 76942 --rvu --policies

# Output:
# Code: 76942
# Description: Echo guide for biopsy
# Facility Price: $64.13
# Found 16 coverage policies

curl -X GET "https://verity.backworkai.com/api/v1/codes/lookup?code=76942&include=policies" \
  -H "Authorization: Bearer vrt_live_YOUR_API_KEY"

Common scenarios

Check if a procedure needs prior auth

result = client.check_prior_auth(
    procedure_codes=["27447"],  # Total knee replacement
    diagnosis_codes=["M17.11"],  # Osteoarthritis, right knee
    state="TX"
)

if result["data"]["pa_required"]:
    print(f"Prior authorization required. Confidence: {result['data']['confidence']}")
    print(f"Documentation needed: {', '.join(result['data']['documentation_checklist'][:3])}")
else:
    print("No prior authorization needed")

The API returns structured criteria, not vague yes/no answers. You get the specific documentation requirements and confidence levels.

Search policies across jurisdictions

Medicare coverage varies by MAC jurisdiction. A procedure covered in Texas might not be covered in Pennsylvania.

result = client.compare_policies(
    procedure_codes=["76942"],
    jurisdictions=["J05", "J06", "JM"]
)

for juris in result["data"]["comparison"]:
    print(f"{juris['jurisdiction']} ({juris['mac_name']}): {len(juris['policies'])} policies")

Monitor policy changes

Policies change constantly. Verity tracks updates across all 19,000+ policies.

from datetime import datetime, timedelta

seven_days_ago = (datetime.now() - timedelta(days=7)).isoformat() + "Z"

result = client.get_policy_changes(since=seven_days_ago, limit=20)

for change in result["data"]:
    print(f"{change['policy_id']}: {change['change_type']} - {change['change_summary']}")

Batch code lookups

Look up multiple codes in a single request:

result = client.batch_lookup_codes(
    codes=["99213", "E11.9", "27447"],
    include=["rvu", "policies"]
)

for code, info in result["data"]["results"].items():
    print(f"{code}: {info['code_system']} - {len(info.get('policies', []))} policies")

Export as CSV or FHIR

Get results in any format — JSON (default), CSV for spreadsheets, or FHIR R4 for EHR integration:

# CSV export
curl "https://verity.backworkai.com/api/v1/policies?icd10=E11.9&format=csv" \
  -H "Authorization: Bearer vrt_live_YOUR_API_KEY"

# FHIR R4 CoverageEligibilityResponse
curl "https://verity.backworkai.com/api/v1/policies?format=fhir" \
  -H "Authorization: Bearer vrt_live_YOUR_API_KEY"

What you get

Structured data Coverage criteria, codes, and requirements as JSON, CSV, or FHIR R4. No PDF parsing required.

Multi-jurisdiction coverage Medicare coverage varies by contractor. We handle all 15 MAC jurisdictions plus commercial payers.

Real-time updates Policies change frequently. We track them all and surface changes via API or webhooks.

AI-extracted criteria Coverage requirements extracted from PDFs by AI, validated for accuracy.

FHIR R4 interoperability Native FHIR CoverageEligibilityResponse output for EHR/EHB integration.

Limitations

Verity covers Medicare coverage policies (LCDs, Articles, NCDs) and commercial payer policies. We don't currently support:

• State Medicaid policies
• Pharmacy benefit management rules

The API returns what's in the policies. It doesn't make coverage decisions for you.

Next steps

Resources

• API Reference - All endpoints
• Authentication - API keys and security
• Rate Limits - Usage limits and pricing tiers
• Error Handling - Handle errors gracefully

New in v1.1

• Batch Code Lookup - Look up 50 codes in one request
• Coverage Evaluation - Evaluate structured criteria against patient data
• Webhooks - Real-time policy change notifications (Enterprise)
• CSV and FHIR R4 output on policy endpoints via ?format=csv or ?format=fhir
• ICD-10 policy filter: ?icd10=E11.9 on search policies