Skip to main content
Review a claim (predictions, no funding)
curl --request POST \
  --url https://api.sandbox.thrivory.com/v1/claims/reviews \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "facility": "ABC",
  "claim_identifier": "CLM-10001",
  "chart_identifier": "PAT-5678",
  "date_of_service": "2025-08-15",
  "date_of_submission": "2025-08-16",
  "servicer_npi": "1111111111",
  "billing_npi": "5556667778",
  "patient_primary_payor_id": "thrivoryid:123456",
  "service_lines": [
    {
      "cpt": "J1745",
      "modifier": "JW",
      "units": 1,
      "amount": 5000
    }
  ],
  "submitted_amount": 5000
}
'
{
  "authorization_id": "<string>",
  "denial_predicted": true,
  "expected_reimbursement": {
    "expected": 123,
    "allowed": 123
  },
  "denial_reasons": [
    {
      "code": "<string>",
      "description": "<string>"
    }
  ],
  "expected_payment_date": "2023-12-25",
  "confidence": 0.5,
  "id": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.thrivory.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

Idempotency-Key
string

Provide a unique key per request to enable safe retries

Body

application/json

Submit encounter/claim context for prediction. Fields align with Thrivory Data Feed Requirements.

claim_identifier
string
required

Unique claim ID

chart_identifier
string
required

Patient chart ID

date_of_service
string<date>
required
servicer_npi
string
required
Pattern: ^[0-9]{10}$
billing_npi
string
required
Pattern: ^[0-9]{10}$
patient_primary_payor_id
string
required

Thrivory payer ID

submitted_amount
number
required
facility
string

Location/facility identifier

date_of_entry
string<date>
date_of_submission
string<date>
patient_primary_payor_text
string
patient_primary_payor_plan_text
string
icd10_codes
string[]
cpt_billing_codes
string
deprecated

Prefer service_lines[].cpt

cpt_billing_modifier
string
deprecated

Prefer service_lines[].modifier

cpt_billing_text
string
balance_payor
number
balance_patient
number
payments_payor
number
payments_patient
number
payments_total
number
settlement_date
string<date>
payment_account_location
string

Last four digits or token reference

denial_code
string
denial_code_text
string
service_lines
object[]

Response

Review results

authorization_id
string
required

Short‑lived authorization handle used to create an adjudication

denial_predicted
boolean
required
expected_reimbursement
object
required
denial_reasons
object[]
expected_payment_date
string<date>
confidence
number

Model confidence

Required range: 0 <= x <= 1
id
string

Review ID