Daybook DocsDaybook Docs
Book a demo
Browse
Book a demo

Check eligibility

POST/v1/eligibility/checks

Run a real-time 270/271 eligibility and benefits check.

Used in Eligibility and benefits2 use cases

Send up to 1,000 checks at once to POST /v1/eligibility/checks/batch with a checks array of the same objects. Batches return pending and each result arrives as an eligibility.completed event.

Call this with AIA brief with this endpoint's request, response and auth, ready for a typed client in your language.

Body

  • payerstringrequired
    Daybook payer id.
  • providerobjectrequired
    Properties
    • npistringrequired
      Billing or rendering NPI.
    • tax_idstring
      Tax id, when the payer verifies by TIN.
  • patientobjectrequired
    Properties
    • first_namestringrequired
    • last_namestringrequired
    • date_of_birthstringrequired
      YYYY-MM-DD.
    • member_idstringrequired
      Member id on the insurance card.
  • date_of_servicestring
    Defaults to today.
  • service_type_codesstring[]
    X12 service type codes. Defaults to ["30"].
Try itEdit the fields and copy the request. Nothing is sent from this page.
curl -X POST https://api.daybookhealthcare.com/v1/eligibility/checks \
  -H "Authorization: Bearer $DAYBOOK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "payer": "bayline",
    "provider": {
      "npi": "1999999984"
    },
    "patient": {
      "first_name": "Jordan",
      "last_name": "Sample",
      "date_of_birth": "1980-01-01",
      "member_id": "W000000001"
    },
    "service_type_codes": [
      "30"
    ]
  }'

Response

  • idstring
    Unique id, prefixed elig_.
  • objectstring
    Always eligibility_check.
  • statusstring
    complete, pending (batches) or failed.
  • coverageobject
    From the 271.
    Properties
    • activeboolean
      Whether coverage is active on the date of service.
    • plan_namestring
    • group_numberstring
    • coverage_startstring
    • coverage_endstring
  • benefitsobject
    Amounts in cents for the service types asked about.
    Properties
    • deductible_remaining_centsinteger
    • out_of_pocket_remaining_centsinteger
    • copay_centsinteger
    • coinsurance_percentinteger
  • errorsobject[]
    AAA rejections from the payer, with code and plain-words reason.
  • raw_271_urlstring
    Signed link to the 271 as received.
  • created_atstring
    RFC 3339 timestamp.
curl -X POST https://api.daybookhealthcare.com/v1/eligibility/checks \
  -H "Authorization: Bearer $DAYBOOK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "payer": "bayline",
    "provider": {
      "npi": "1999999984"
    },
    "patient": {
      "first_name": "Jordan",
      "last_name": "Sample",
      "date_of_birth": "1980-01-01",
      "member_id": "W000000001"
    },
    "service_type_codes": [
      "30"
    ]
  }'
Response 200
{
  "id": "elig_01JBXD0P6Y1S",
  "object": "eligibility_check",
  "status": "complete",
  "coverage": {
    "active": true,
    "plan_name": "Bayline Choice PPO",
    "group_number": "000000",
    "coverage_start": "2026-01-01",
    "coverage_end": null
  },
  "benefits": {
    "deductible_remaining_cents": 42000,
    "out_of_pocket_remaining_cents": 310000,
    "copay_cents": 3000,
    "coinsurance_percent": 20
  },
  "errors": [],
  "raw_271_url": "https://files.daybookhealthcare.com/x/elig_01JBXD0P6Y1S/271?sig=...",
  "created_at": "2026-10-29T15:22:05Z"
}