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:
Both requests and responses are gzip-compressed. Send Content-Type: application/json and Content-Encoding: gzip with a gzip-compressed JSON body — uncompressed requests will be rejected. Successful responses are also returned with Content-Encoding: gzip; ensure your client sends Accept-Encoding: gzip or handles decompression explicitly.

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 provisioned exclusively for your organization. Do not use another customer’s endpoint URL.Sandbox credentials include a separate endpoint URL and Token URL.

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 and bound to your tenant
  4. Proxies the request to the BillSentry processing engine (internal, you do not call this directly)