Create Encounter Eligibility

Beta

POST

/eligibility-checks/v1/eligibility

POST

/eligibility-checks/v1/eligibility

curl -X POST https://pre-api.joincandidhealth.com/eligibility-checks/v1/eligibility \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "encounter_id": "encounter_id"
}'

200Successful

{
  "id": "id",
  "source": "STEDI",
  "dateOfService": "2024-01-15T09:30:00Z",
  "payerId": "payerId",
  "providerNPI": "providerNPI",
  "status": "ACTIVE",
  "errors": [
    {
      "source": "CANDID",
      "errorDetails": {
        "field?": "field?",
        "description?": "description?",
        "location?": "location?",
        "possibleResolutions?": "possibleResolutions?",
        "code?": "code?",
        "followupAction?": "followupAction?"
      }
    },
    {
      "source": "CANDID",
      "errorDetails": {
        "field?": "field?",
        "description?": "description?",
        "location?": "location?",
        "possibleResolutions?": "possibleResolutions?",
        "code?": "code?",
        "followupAction?": "followupAction?"
      }
    }
  ],
  "dependent": {
    "name": "name"
  }
}

Fetch an eligibility check for the patient for the date of service, npi, and payer

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Request

This endpoint expects an object.

encounter_idstringRequired

Response

This endpoint returns an object.

idstring

sourceenum

dateOfServicedatetime

payerIdstring

providerNPIstring

statusenum

enum to represent the status of a patient's coverage

errorslist of objects

dependentobjectOptional