> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cairhealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Send Mock Eligibility Requests

## Mock Requests

If you want to test with dummy data on the [Real Time Eligibility Check Endpoint](../eligibility), 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:

<Accordion title="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."
  }
  ```
</Accordion>

<Accordion title="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."
  }
  ```
</Accordion>

<Accordion title="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."
  }
  ```
</Accordion>

<Accordion title="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."
  }
  ```
</Accordion>