Overview
API Authentication
Eligibility
Enrollments
Claims
AI Phone Calls
Eligibility
Send Mock Eligibility Requests
Eligibility
Send Mock Eligibility Requests
Mock Requests
If you want to test with dummy data on the Real Time Eligibility Check Endpoint, you must set the mockRequest parameter to true in your request body.
You will need to specify the patient information exactly as displayed below, or the endpoint will error with a 500: Mock request not found.
The 4 examples and their associated responses are below:
Request
curl --request POST \
--url 'https://forecaster.cairhealth.com/api/eligibility/v1' \
--header 'Authorization: Bearer {your_auth_token}' \
--header 'Content-Type: application/json' \
--data '{
"patientFirstName": "John",
"patientLastName": "Doe",
"patientDOB": "01-01-1980",
"patientMemberId": "123456789",
"dateOfCoverage": "01-01-2025",
"payerId": "PAYER001",
"providerId": "PROVIDER001",
"mockRequest": true
}'
Response
{
"inNetwork": {
"individual": {
"copay": "$20.00",
"deductible": {
"total": "$500.00",
"remaining": "$200.00"
},
"coinsurance": "10%",
"stopLoss": "$2,000.00"
},
"family": {
"copay": "$50.00",
"deductible": {
"total": "$1,000.00",
"remaining": "$500.00"
},
"coinsurance": "20%",
"stopLoss": "$5,000.00"
}
},
"outNetwork": {
"individual": {
"copay": "$40.00",
"deductible": {
"total": "$1,000.00",
"remaining": "$800.00"
},
"coinsurance": "30%",
"stopLoss": "$4,000.00"
},
"family": {
"copay": "$100.00",
"deductible": {
"total": "$2,000.00",
"remaining": "$1,500.00"
},
"coinsurance": "40%",
"stopLoss": "$10,000.00"
}
},
"message": "Mock Eligibility check successful."
}
Request
curl --request POST \
--url 'https://forecaster.cairhealth.com/api/eligibility/v1' \
--header 'Authorization: Bearer {your_auth_token}' \
--header 'Content-Type: application/json' \
--data '{
"patientFirstName": "Jane",
"patientLastName": "Smith",
"patientDOB": "02-02-1985",
"patientMemberId": "987654321",
"dateOfCoverage": "02-02-2025",
"payerId": "PAYER002",
"providerId": "PROVIDER002",
"mockRequest": true
}'
Response
{
"inNetwork": {
"individual": {
"copay": "$15.00",
"deductible": {
"total": "$300.00",
"remaining": "$100.00"
},
"coinsurance": "5%",
"stopLoss": "$1,500.00"
},
"family": {
"copay": "$30.00",
"deductible": {
"total": "$600.00",
"remaining": "$300.00"
},
"coinsurance": "10%",
"stopLoss": "$3,000.00"
}
},
"outNetwork": {
"individual": {
"copay": "$50.00",
"deductible": {
"total": "$1,200.00",
"remaining": "$1,000.00"
},
"coinsurance": "35%",
"stopLoss": "$5,000.00"
},
"family": {
"copay": "$120.00",
"deductible": {
"total": "$2,500.00",
"remaining": "$2,000.00"
},
"coinsurance": "50%",
"stopLoss": "$12,000.00"
}
},
"message": "Mock Eligibility check successful."
}
Request
curl --request POST \
--url 'https://forecaster.cairhealth.com/api/eligibility/v1' \
--header 'Authorization: Bearer {your_auth_token}' \
--header 'Content-Type: application/json' \
--data '{
"patientFirstName": "Alice",
"patientLastName": "Johnson",
"patientDOB": "03-03-1999",
"patientMemberId": "456789123",
"dateOfCoverage": "03-03-2025",
"payerId": "PAYER003",
"providerId": "PROVIDER003",
"mockRequest": true
}'
Response
{
"inNetwork": {
"individual": {
"copay": "$25.00",
"deductible": {
"total": "$700.00",
"remaining": "$700.00"
},
"coinsurance": "15%",
"stopLoss": "$3,000.00"
},
"family": {
"copay": "$60.00",
"deductible": {
"total": "$1,500.00",
"remaining": "$1,500.00"
},
"coinsurance": "25%",
"stopLoss": "$7,000.00"
}
},
"outNetwork": {
"individual": {
"copay": "$60.00",
"deductible": {
"total": "$1,500.00",
"remaining": "$1,500.00"
},
"coinsurance": "40%",
"stopLoss": "$6,000.00"
},
"family": {
"copay": "$150.00",
"deductible": {
"total": "$3,000.00",
"remaining": "$3,000.00"
},
"coinsurance": "60%",
"stopLoss": "$15,000.00"
}
},
"message": "Mock Eligibility check successful."
}
Request
curl --request POST \
--url 'https://forecaster.cairhealth.com/api/eligibility/v1' \
--header 'Authorization: Bearer {your_auth_token}' \
--header 'Content-Type: application/json' \
--data '{
"patientFirstName": "Bob",
"patientLastName": "Brown",
"patientDOB": "04-04-2000",
"patientMemberId": "789123456",
"dateOfCoverage": "04-04-2025",
"payerId": "PAYER004",
"providerId": "PROVIDER004",
"mockRequest": true
}'
Response
{
"message": "Mock: Error retrieving eligibility data."
}
On this page