Skip to main content
POST
/
v1
/
cost-estimate
Create Cost Estimate
curl --request POST \
  --url https://api.soharhealth.com/v1/cost-estimate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "verificationId": "fb701ac1-1246-4860-b1ec-bd916b97a990",
  "tin": "752326127",
  "networkStatus": "inn",
  "tier": 1,
  "lines": [
    {
      "code": "90837",
      "contractedRate": 100
    },
    {
      "code": "99213",
      "contractedRate": 80
    }
  ]
}'
{
  "requestId": "fb701ac1-1246-4860-b1ec-bd916b97a990",
  "paidAmount": 180,
  "patientResponsibility": 120,
  "lines": [
    {
      "code": "90837",
      "adjustments": [
        {
          "reasonCode": "1",
          "amount": 50
        },
        {
          "reasonCode": "2",
          "amount": 30
        }
      ]
    },
    {
      "code": "99213",
      "adjustments": [
        {
          "reasonCode": "1",
          "amount": 25
        },
        {
          "reasonCode": "3",
          "amount": 15
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
verificationId
string<uuid>
required

A Sohar Verification ID

Example:

"fb701ac1-1246-4860-b1ec-bd916b97a990"

​
tin
string
required

A Tax Identification Number (9 digits)

Example:

"752326127"

​
networkStatus
enum<string>
required

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

Available options:
inn,
oon
Example:

"inn"

​
lines
object[]
required

An array of billing lines with codes and contracted rates

Minimum length: 1
​
tier
number | null

The benefits tier, if multiple benefits are available

Required range: x >= 1
Example:

1

Response

A cost estimate

​
requestId
string<uuid>
required

Unique identifier for the cost estimate request

Example:

"0942a568-b015-438e-b7be-d0234f401f35"

​
verificationId
string<uuid>
required

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

Example:

"fb701ac1-1246-4860-b1ec-bd916b97a990"

​
paidAmount
number
required

The total amount paid by the payer in USD

Example:

80

​
patientResponsibility
number
required

The total amount owed by the patient in USD

Example:

120

​
lines
object[]
required

Cost estimate breakdown for each billing line