Mock Requests
If you want to test with dummy data on the Real Time Eligibility Check Endpoint, you must set themockRequest 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:
Example 1: John Doe
Example 1: John Doe
Request
Copy
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
Copy
{
"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."
}
Example 2: Jane Smith
Example 2: Jane Smith
Request
Copy
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
Copy
{
"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."
}
Example 3: Alice Johnson
Example 3: Alice Johnson
Request
Copy
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
Copy
{
"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."
}
Example 4: Bob Brown (Error Response)
Example 4: Bob Brown (Error Response)
Request
Copy
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
Copy
{
"message": "Mock: Error retrieving eligibility data."
}