Skip to main content
POST
/
api
/
eligibility
/
v1
cURL
curl --request POST \
  --url https://forecaster.cairhealth.com/api/eligibility/v1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "patientFirstName": "John",
  "patientLastName": "Doe",
  "patientDOB": "01-01-1991",
  "patientMemberId": "U1234567",
  "dateOfCoverage": "03-24-2025",
  "payerId": "HGJLR",
  "providerId": "0195b964-5b2c-7bb3-875a-276ad770dc66"
}'
{
  "inNetwork": {
    "individual": {
      "copay": "N/A",
      "deductible": {
        "total": "$2,000.00",
        "remaining": "$2,000.00"
      },
      "coinsurance": "N/A",
      "stopLoss": "$6,850.00"
    },
    "family": {
      "copay": "N/A",
      "deductible": {
        "total": "N/A",
        "remaining": "N/A"
      },
      "coinsurance": "N/A",
      "stopLoss": "N/A"
    }
  },
  "outNetwork": {
    "individual": {
      "copay": "N/A",
      "deductible": {
        "total": "$6,000.00",
        "remaining": "$6,000.00"
      },
      "coinsurance": "N/A",
      "stopLoss": "$14,000.00"
    },
    "family": {
      "copay": "N/A",
      "deductible": {
        "total": "N/A",
        "remaining": "N/A"
      },
      "coinsurance": "N/A",
      "stopLoss": "N/A"
    }
  },
  "message": "Eligibility check successful"
}
The following endpoint requires provider enrollment through our platform. Refer to the platform help guides or contact Cair Support with any questions.

​
Mock Requests

To send a mock request without incurring charges, set the mockRequest parameter in the body to true. There are 4 scenarios you may test with. Refer to Mock Eligibility for the scenarios.

​
Data Richness

The response you receive will vary by payer. We parse the EDI response to the best of our ability, and the presence of an N/A in any field does not necessarily mean that the benefit is not present in the subscriber’s insurance plan.

Authorizations

​
Authorization
string
header
required

Body

application/json
​
patientFirstName
string
required
​
patientLastName
string
required
​
patientDOB
string
required
​
patientMemberId
string
required
​
dateOfCoverage
string
required
​
payerId
string
required
​
providerId
string
required
​
mockRequest
boolean

Response

​
inNetwork
object
​
outNetwork
object
​
message
string