Daybook DocsDaybook Docs
Browse

Retrieve a denial

GET/v1/denials/{id}

Fetch a denial with its codes, the cause Daybook sorted it into, and the recommended next step.

Used in Denials and appeals3 use cases

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

Path parameters

  • idstringrequired
    The denial id.
Try itEdit the fields and copy the request. Nothing is sent from this page.
curl -X GET https://api.daybookhealthcare.com/v1/denials/den_01JBXG2N5R8W \
  -H "Authorization: Bearer $DAYBOOK_API_KEY"

Response

  • idstring
    Unique id, prefixed den_.
  • objectstring
    Always denial.
  • remitstring
    The remit the denial came on.
  • claimstring
    Your claim id.
  • codesobject
    Properties
    • groupstring
      CAS group code.
    • carcstring
    • rarcstring[]
  • causestring
    missing_auth, eligibility, coding, timely_filing, duplicate, medical_necessity, coordination_of_benefits, credentialing, bundling or other.
  • cause_detailstring
    Why Daybook sorted it there, in plain words.
  • recommended_actionstring
    appeal, correct_and_resubmit, call_payer, bill_patient, bill_secondary or write_off.
  • appealableboolean
  • appeal_deadlinestring
    From the payer's filing limit, when known.
  • amount_centsinteger
    Amount denied.
curl -X GET https://api.daybookhealthcare.com/v1/denials/den_01JBXG2N5R8W \
  -H "Authorization: Bearer $DAYBOOK_API_KEY"
Response 200
{
  "id": "den_01JBXG2N5R8W",
  "object": "denial",
  "remit": "remit_01JBXF8B3C4V",
  "claim": "A-31120-1",
  "codes": {
    "group": "CO",
    "carc": "197",
    "rarc": [
      "N54"
    ]
  },
  "cause": "missing_auth",
  "cause_detail": "Precertification was required for D4341 and none was on file.",
  "recommended_action": "appeal",
  "appealable": true,
  "appeal_deadline": "2027-04-19",
  "amount_cents": 88000
}