Skip to main content
Typical response time: under 250 ms. Covers 50 states (including OWCP).Check API status for live uptime.
The BillSentry BillReview API allows technology partners and payers to submit bill data and receive structured pricing decisions that can be incorporated directly into claims or adjudication workflows.

​
What you get in every response

  • Allowed reimbursement amounts per service line
  • Reduction explanations and reason codes
  • Step-by-step calculation logic (RuleTrace™)
  • Fee schedule citations with source URLs
  • A shareable QR-linked review report

​
How authentication works

BillSentry uses a two-header model on every request:

​
Request and response encoding

See Authentication for full details. Exception: POST /v1/facility accepts plain JSON only.

​
Your credentials

BillSentry will provision these during onboarding. Store them securely and treat them the same as passwords.
Each API customer receives a dedicated API endpoint URL for their organization. That same URL is used for both sandbox and production. Sandbox vs production is determined by your API key (and the matching M2M credentials). Do not use another customer’s endpoint URL.You will receive separate sandbox and production credential sets (Client ID/Secret + API key). Use the matching set for each environment.

​
Architecture

Your dedicated API gateway:
  1. Validates the Bearer token signature
  2. Confirms the token sub claim matches your registered M2M client ID
  3. Confirms the x-api-key is active, bound to your tenant, and selects sandbox or production
  4. Proxies the request to the BillSentry processing engine (internal, you do not call this directly)