Daybook DocsDaybook Docs
Book a demo
Browse
Book a demo

Check claim status

POST/v1/claim-status/checks

Run a real-time 276/277 claim status check.

Used in Claim status2 use cases

For volume, send up to 1,000 checks to POST /v1/claim-status/checks/batch, or let a rule start them for you, such as every claim with no response in 30 days.

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.
  • claimobjectrequired
    Properties
    • payer_claim_numberstring
      The payer's claim number (ICN), when you have it.
    • patient_control_numberstring
      Your claim id as sent in CLM01.
    • date_of_servicestringrequired
      First date of service, YYYY-MM-DD.
    • billed_amount_centsinteger
      Total billed, in cents.
Try itEdit the fields and copy the request. Nothing is sent from this page.
curl -X POST https://api.daybookhealthcare.com/v1/claim-status/checks \
  -H "Authorization: Bearer $DAYBOOK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "payer": "keystone",
    "provider": {
      "npi": "1999999984",
      "tax_id": "00-0000000"
    },
    "patient": {
      "first_name": "Jordan",
      "last_name": "Sample",
      "date_of_birth": "1980-01-01",
      "member_id": "W000000001"
    },
    "claim": {
      "patient_control_number": "A-20817-1",
      "date_of_service": "2026-09-30",
      "billed_amount_cents": 41000
    }
  }'

Response

  • idstring
    Unique id, prefixed cs_.
  • objectstring
    Always claim_status_check.
  • statusstring
    complete, pending (batches) or failed.
  • claim_statusobject
    From the 277.
    Properties
    • categorystring
      Normalized: paid, denied, pending, in_process, returned or not_on_file.
    • category_codestring
      X12 claim status category code, such as F1 or A2.
    • status_codestring
      X12 claim status code.
    • effective_datestring
    • paid_amount_centsinteger
    • check_or_eft_numberstring
    • payer_claim_numberstring
  • changedboolean
    Whether the status differs from the last check on this claim.
  • raw_277_urlstring
    Signed link to the 277 as received.
  • created_atstring
    RFC 3339 timestamp.
curl -X POST https://api.daybookhealthcare.com/v1/claim-status/checks \
  -H "Authorization: Bearer $DAYBOOK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "payer": "keystone",
    "provider": {
      "npi": "1999999984",
      "tax_id": "00-0000000"
    },
    "patient": {
      "first_name": "Jordan",
      "last_name": "Sample",
      "date_of_birth": "1980-01-01",
      "member_id": "W000000001"
    },
    "claim": {
      "patient_control_number": "A-20817-1",
      "date_of_service": "2026-09-30",
      "billed_amount_cents": 41000
    }
  }'
Response 200
{
  "id": "cs_01JBXE4H9M2T",
  "object": "claim_status_check",
  "status": "complete",
  "claim_status": {
    "category": "paid",
    "category_code": "F1",
    "status_code": "65",
    "effective_date": "2026-10-21",
    "paid_amount_cents": 31200,
    "check_or_eft_number": "EFT00048213",
    "payer_claim_number": "2026294000123"
  },
  "changed": true,
  "raw_277_url": "https://files.daybookhealthcare.com/x/cs_01JBXE4H9M2T/277?sig=...",
  "created_at": "2026-10-29T15:30:00Z"
}