Skip to main content

​
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."
}
⌘I