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:

Example 1: John Doe

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."
}

Example 2: Jane Smith

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."
}

Example 3: Alice Johnson

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."
}

Example 4: Bob Brown (Error Response)

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."
}

Overview

API Authentication

Eligibility

Enrollments

Claims

AI Phone Calls

Mock Requests

Request

Response

Request

Response

Request

Response

Request

Response

Overview

API Authentication

Eligibility

Enrollments

Claims

AI Phone Calls

​Mock Requests

Mock Requests