# API Reference
URL: https://backworkhealth.com/docs/api

Complete reference for the Backwork REST API. All endpoints are prefixed with https://backworkhealth.com/api/v1.

The Backwork API is a REST API that returns JSON. All endpoints require an API key passed as a Bearer token.

```bash
Authorization: Bearer bwk_live_YOUR_API_KEY
```

Create a live key in [API usage and keys](https://backworkhealth.com/api-usage) once your organization has request credits. Every call spends credits; see [Rate Limits](/docs/rate-limits) for the request cost of each endpoint. See [Authentication](/docs/authentication) for key types and scopes.

## Infrastructure [#infrastructure]

<Cards>
  <Card title="Health check" href="/docs/api/getHealth" description="Verify the API is operational and check version." />

  <Card title="List jurisdictions" href="/docs/api/listJurisdictions" description="List all MAC contractor jurisdictions covered." />
</Cards>

## Certified Releases [#certified-releases]

<Cards>
  <Card title="List certified release decisions" href="/docs/api/listCertifiedReleaseDecisions" description="Query an immutable, evidence-bound release using its dedicated exact-scope API key." />
</Cards>

## Policies [#policies]

<Cards>
  <Card title="Search and list policies" href="/docs/api/listPolicies" description="Search Medicare LCDs, Articles, NCDs, and commercial payer policies with filters." />

  <Card title="Get policy by ID" href="/docs/api/getPolicy" description="Fetch the full structured content of a single policy." />

  <Card title="Get policy change feed" href="/docs/api/getPolicyChanges" description="Paginated feed of policy updates since a given date." />

  <Card title="Compare policies across jurisdictions" href="/docs/api/comparePolicies" description="Side-by-side coverage comparison for a procedure across MAC jurisdictions." />
</Cards>

## Code Lookup [#code-lookup]

<Cards>
  <Card title="Look up a medical code" href="/docs/api/lookupCode" description="Get RVU, coverage, and policy data for a single CPT, HCPCS, or ICD-10 code." />

  <Card title="Batch code lookup" href="/docs/api/batchLookupCodes" description="Look up up to 50 codes in a single request." />

  <Card title="Get spending by code" href="/docs/api/getSpendingByCode" description="Medicaid spending data by procedure code." />

  <Card title="Search coverage criteria" href="/docs/api/searchCriteria" description="Full-text search across extracted coverage criteria text." />

  <Card title="Search drug formulary evidence" href="/docs/api/searchDrugFormularyEvidence" description="Search pharmacy-benefit evidence across major PBMs." />
</Cards>

## Coverage & Prior Auth [#coverage--prior-auth]

<Cards>
  <Card title="Evaluate coverage criteria" href="/docs/api/evaluateCoverage" description="Evaluate structured criteria against patient-level inputs." />

  <Card title="Check prior authorization" href="/docs/api/checkPriorAuth" description="Determine if a procedure requires prior auth and what documentation is needed." />

  <Card title="Validate claim" href="/docs/api/validateClaim" description="Pre-submission denial risk check for a single claim." />

  <Card title="Validate coverage and denial risk" href="/docs/api/validateClaims" description="Batch denial risk validation across multiple procedure codes." />

  <Card title="Score claim denial risk" href="/docs/api/scoreClaimDenialRisk" description="Score documentation against payer requirements before submitting a claim." />

  <Card title="Research prior authorization" href="/docs/api/researchPriorAuth" description="Trigger an async deep-research run for complex PA requirements." />

  <Card title="Get prior auth research status" href="/docs/api/getPriorAuthResearch" description="Poll for results from a prior auth research run." />

  <Card title="Assess prior auth readiness" href="/docs/api/assessPriorAuthReadiness" description="Check whether clinical documentation satisfies researched PA requirements." />
</Cards>

## Agent Tools [#agent-tools]

<Cards>
  <Card title="List agent tools" href="/docs/api/listAgentTools" description="Fetch the manifest of available tools for coverage intelligence agents." />

  <Card title="Invoke agent tool" href="/docs/api/invokeAgentTool" description="Execute a named agent tool with validated inputs." />
</Cards>

## Webhooks [#webhooks]

<Cards>
  <Card title="List webhooks" href="/docs/api/listWebhooks" description="List all configured webhook endpoints for your account." />

  <Card title="Create webhook" href="/docs/api/createWebhook" description="Register a new endpoint for webhook event notifications." />

  <Card title="Update webhook" href="/docs/api/updateWebhook" description="Modify an existing webhook's URL, events, or status." />

  <Card title="Delete webhook" href="/docs/api/deleteWebhook" description="Remove a webhook endpoint." />

  <Card title="Send test webhook" href="/docs/api/testWebhook" description="Fire a test payload to verify your endpoint is reachable." />
</Cards>

## Policy Change Compliance [#policy-change-compliance]

<Cards>
  <Card title="List unreviewed changes" href="/docs/api/listUnreviewedChanges" description="Changes that have not yet been acknowledged by your team." />

  <Card title="Acknowledge a policy change" href="/docs/api/acknowledgeChange" description="Mark a single policy diff as reviewed." />

  <Card title="Bulk acknowledge changes" href="/docs/api/bulkAcknowledgeChanges" description="Acknowledge multiple diffs in one request." />

  <Card title="Get compliance statistics" href="/docs/api/getComplianceStats" description="Review rates and outstanding acknowledgment counts." />
</Cards>