Skip to main content
POST
/
api
/
eligibility
/
cob
/
v1
cURL
curl --request POST \
  --url https://forecaster.cairhealth.com/api/eligibility/cob/v1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "patientFirstName": "John",
  "patientLastName": "Doe",
  "patientDOB": "01-01-1991",
  "patientMemberId": "U1234567",
  "dateOfCoverage": "03-24-2025",
  "payerId": "HGJLR",
  "providerId": "0195b964-5b2c-7bb3-875a-276ad770dc66"
}'
{
  "cobCode": "CobInstanceExistsPrimacyDetermined",
  "requestedPlanBenefits": [
    {
      "payerName": "Blue Cross",
      "serviceTypeCodes": [
        {
          "code": "30",
          "name": "Health Benefit Plan Coverage"
        }
      ],
      "benefitDate": {
        "planStartDate": "2024-01-01"
      }
    }
  ],
  "additionalPlanBenefitInfo": [
    {
      "payerName": "Aetna",
      "payerPrimacy": "SecondaryPayer",
      "serviceTypeCodes": [
        {
          "code": "30",
          "name": "Health Benefit Plan Coverage"
        }
      ],
      "benefitDate": {
        "overlapBeginDate": "2024-01-01",
        "overlapEndDate": "2024-12-31",
        "planStartDate": "2024-01-01",
        "planEndDate": "2024-12-31",
        "coordinationOfBenefits": "2024-01-01"
      },
      "subscriber": {
        "firstName": "John",
        "lastName": "Doe",
        "dateOfBirth": "1990-01-01",
        "memberId": "W9876543"
      }
    }
  ]
}
The following endpoint requires provider enrollment through our platform. Refer to the platform help guides or contact Cair Support with any questions.
Use this endpoint to search for health benefit coverage information in the case that a patient has more than one insurance plan. This check can also be performed as part of an eligibility check automatically by setting the runCobCheck flag to true.

​
Possible COB codes

CodeDescription
MemberFoundNoCOBNo coordination of benefits found for this member
CoverageOverlapNoBenefitOverlapMultiple coverages found but no overlap in benefits
CoverageOverlapExistsNotSubjectToCobCoverage overlap exists but is not subject to COB
CobInstanceExistsPrimacyUndeterminedCOB exists but primary/secondary status is undetermined. Likely requires a phone call to verify
CobInstanceExistsPrimacyDeterminedCOB exists with determined primacy for payer

Authorizations

​
Authorization
string
header
required

Body

application/json
​
patientFirstName
string
required
​
patientLastName
string
required
​
dateOfCoverage
string
required
​
payerId
string
required
​
providerId
string
required
​
patientDOB
string
​
patientMemberId
string
​
patientSSN
string
​
dependentFirstName
string
​
dependentLastName
string
​
dependentDOB
string
​
serviceTypeCodes
string[]

Response

​
cobCode
string
​
requestedPlanBenefits
object[]
​
additionalPlanBenefitInfo
object[]