---
title: "Review a claim (predictions, no funding)"
method: POST
path: "/v1/claims/reviews"
tags: ["Claims"]
---

# Review a claim (predictions, no funding)

`POST /v1/claims/reviews`

## Headers

- `Idempotency-Key` string

## Request body

- ClaimReviewRequest — Submit encounter/claim context for prediction. Fields align with Thrivory Data Feed Requirements.
  - `facility` string — Location/facility identifier
  - `claim_identifier` string, required — Unique claim ID
  - `chart_identifier` string, required — Patient chart ID
  - `date_of_entry` string, date
  - `date_of_service` string, date, required
  - `date_of_submission` string, date
  - `servicer_npi` string, required
  - `billing_npi` string, required
  - `patient_primary_payor_text` string
  - `patient_primary_payor_id` string, required — Thrivory payer ID
  - `patient_primary_payor_plan_text` string
  - `icd10_codes` string[]
  - `cpt_billing_codes` string — Prefer service_lines[].cpt
  - `cpt_billing_modifier` string — Prefer service_lines[].modifier
  - `cpt_billing_text` string
  - `submitted_amount` number, required
  - `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` ServiceLine[]
    - `cpt` string, required — CPT/HCPCS code
    - `modifier` string
    - `units` number, required
    - `amount` number, required

## Response `200`

Review results

- ClaimReviewResponse
  - `authorization_id` string, required — Short‑lived authorization handle used to create an adjudication
  - `denial_predicted` boolean, required
  - `denial_reasons` ReasonCode[]
    - `code` string, required
    - `description` string, required
  - `expected_reimbursement` object, required
    - `allowed` number
    - `expected` number, required
  - `expected_payment_date` string, date
  - `confidence` number — Model confidence
  - `id` string — Review ID

## Other responses

- `400` — 400 Bad Request
- `401` — 401 Unauthorized
- `404` — 404 Not Found
- `500` — 500 Server Error

---

[API](https://skmtc.net/thrivory-com/apis/thrivory-thrivenow-api.md) · [All operations](https://skmtc.net/thrivory-com/apis/thrivory-thrivenow-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thrivory-com/thrivory-thrivenow-api/versions/9893450caa9b/schema)