Developer Platform

BillSentry Developer Platform

Integrate workers' compensation bill review, fee schedule pricing, and RuleTrace™ documentation directly into your application using the BillSentry REST API.

Built for real-time processing, predictable performance, and straightforward implementation.

View API Reference
ℹ

The BillSentry Analyzer application runs entirely on the same public API available to integration partners.

This ensures consistent results between UI workflows and API integrations.

API Overview

The BillSentry API allows technology partners to submit bill data and receive structured pricing decisions that can be incorporated directly into claims or review workflows.

Responses may include:

Most integrations use real-time API requests as part of claims or bill review workflows.

Key Characteristics

Protocol REST / JSON
Response time < 250ms typical
Authentication OAuth2 client credentials
API key scope Tenant-scoped
Versioning Versioned endpoints
Testing Sandbox environment available
Architecture Production-ready

Getting Started

1

Request sandbox access

Receive test credentials and environment access.

2

Configure authentication

Set up OAuth client credentials and API key authorization.

3

Submit test bills

Validate integration using test workflows.

4

Production rollout

Production credentials are issued after successful testing.

View API Reference

Authentication

BillSentry uses a layered authentication approach designed for secure system integrations.

OAuth2 client credentials

Used for secure machine-to-machine authentication.

API key authorization

Provides tenant-level access control.

Secure transport

All requests require HTTPS. Minimum TLS 1.2.

Tenant isolation

Requests are scoped to your organization.

Full implementation details are available in the API documentation.

View API Authentication Reference

Example Request

POST /v1/review

{
  "jurisdiction": "NY",
  "billType": "professional",
  "providerTaxId": "123456789",
  "lines": [
    {
      "cpt": "99213",
      "charge": 175.00,
      "units": 1
    }
  ]
}

Response includes

  • allowedAmount
  • reductionReasons[]
  • calculationDetails
  • ruleCitations[]
  • ruleTraceReference

See full request and response examples in the API documentation.

View API Request Reference

Common Integration Patterns

Real-time pricing workflows

Submit bills during claims processing.

Pre-adjudication validation

Evaluate reimbursement before claim processing.

Audit workflows

Validate pricing decisions programmatically.

Provider reimbursement tools

Allow providers to validate expected reimbursement.

Performance and Reliability

BillSentry is designed for operational processing workloads. Typical response times are under 250ms.

The platform supports:

Additional technical details are available in the documentation.

Versioning and Change Management

BillSentry maintains versioned API endpoints to support stable integrations.

This allows partners to integrate with confidence.

Error Handling

The BillSentry API returns structured error responses designed to simplify troubleshooting.

Typical categories include:

4xx Validation errors
401 Authentication failures
403 Authorization issues
5xx Processing exceptions

Full error definitions are available in the documentation.

View API Errors Reference

Sandbox Environment

A sandbox environment is available to support integration testing prior to production deployment.

Sandbox access includes:

Engineering Support

BillSentry works directly with partner engineering teams during integration.

Support may include:

Start integrating with BillSentry

Request sandbox access to begin integration or review the technical documentation.

View API Reference