Get started

Revenue Guard API

Submit orders, evaluate payer rules, and keep sandbox and live traffic isolated.

Revenue Guard helps CrelioHealth customers classify incoming orders against payer rules before downstream billing workflows begin. Use the public API to look up payer IDs and submit orders for evaluation.

Use the E2E development API while building integrations:

https://e2e-rg-api.crelio.solutions

All public paths include /public/v1.

How integrations work

1

Create an API key

Create an organization-scoped API key in the Revenue Guard dashboard. Keys are environment-specific:

  • Sandbox keys start with rg_test_
  • Live keys start with rg_live_
2

Find payer IDs

Call GET /public/v1/payer-categories for the public reference list, GET /public/v1/payers to list payer IDs, or GET /public/v1/payers/{payerId} to verify one payer. Payer IDs are passed in payer_ids when submitting orders.

3

Submit orders

Call POST /public/v1/orders with the order, patient, insurance, and document evidence needed for rule evaluation.

$curl https://e2e-rg-api.crelio.solutions/public/v1/orders \
>  -H "X-API-Key: $REVENUE_GUARD_API_KEY" \
>  -H "Content-Type: application/json" \
>  -d '{
>    "order_id": "ORD-1001",
>    "payer_ids": ["00000000-0000-0000-0000-000000000000"],
>    "patient_info": {
>      "patient_uid": "PAT-123"
>    }
>  }'
4

Track the environment

Responses for environment-owned resources include environment and livemode. Use them to confirm sandbox traffic never mixes with live data.

Core concepts

API keys

Authenticate requests with the X-API-Key header. The key determines whether the request targets sandbox or live data.

Orders

Submit orders for payer rule classification and receive the generated validation result.

Payers

Find payer IDs and reference data used by order submissions.

SDKs

SDKs are planned from this public API contract.

Environments

Do not send a separate environment header. The API key is authoritative for sandbox vs live routing.

Start with sandbox keys while developing. Move to live keys only after your payer lookup and order submission workflows are verified end to end.