---
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`

## Request

- Base URL: `https://api.sandbox.thrivory.com`
- URL: `https://api.sandbox.thrivory.com/v1/claims/reviews`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.thrivory.com/v1/oauth/token` scopes: `claims:read`, `claims:write`, `settlements:write`, `metadata:read`, `webhooks:manage`, `imports:write`, `payouts:write`

## 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

## Changes

- **2025-09-11** `d3470b9a79f0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/thrivory-com/apis/thrivory-thrivenow-api/changes/v1/claims/reviews/post.md)

---

[API](https://skmtc.dev/thrivory-com/apis/thrivory-thrivenow-api.md) - [All operations](https://skmtc.dev/thrivory-com/apis/thrivory-thrivenow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thrivory-com/apis/thrivory-thrivenow-api/revisions/9893450caa9b?raw)