Sign in

v1

latestOpenAPI 3.0.0MIT2026-07-22275773.2 KB
CostEstimate

Create Cost Estimate

Creates a cost estimate for medical billing codes based on verification data.

post/v1/cost-estimate

Request body

verificationIdstring uuid required

A Sohar Verification ID

tinstring required

A Tax Identification Number (9 digits)

networkStatus'inn' | 'oon' required

Determines whether the benefits apply to patients in or out of network

tiernumber nullable

The benefits tier, if multiple benefits are available

Example request

{
  "verificationId": "fb701ac1-1246-4860-b1ec-bd916b97a990",
  "tin": "752326127",
  "networkStatus": "inn",
  "tier": 1,
  "lines": [
    {
      "code": "90837",
      "contractedRate": 150
    }
  ]
}

Response

A cost estimate

requestIdstring uuid required

Unique identifier for the cost estimate request

verificationIdstring uuid required

The Sohar ID for the verification used to create this cost estimate

paidAmountnumber required

The total amount paid by the payer in USD

patientResponsibilitynumber required

The total amount owed by the patient in USD

Example response

{
  "requestId": "0942a568-b015-438e-b7be-d0234f401f35",
  "verificationId": "fb701ac1-1246-4860-b1ec-bd916b97a990",
  "paidAmount": 80,
  "patientResponsibility": 120,
  "lines": [
    {
      "code": "90837",
      "adjustments": [
        {
          "reasonCode": "1",
          "amount": 120
        }
      ]
    }
  ]
}