Draft an appeal

POST/v1/appeals

Draft an appeal letter from a denial's data, for a biller to review and send.

Used in Denials and appeals2 use cases

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

Body

denialstringrequired
The denial id.
supporting_documentsstring[]
HTTPS links Daybook may cite, such as the auth approval or chart notes.
signerobject
Name and title for the signature block.

Try itEdit the fields and copy the request. Nothing is sent from this page.

API keykept in this tab; masked on screen, copied in full

denialstringrequired

supporting_documentsstring[]

signerobject

curl -X POST https://api.daybookhealthcare.com/v1/appeals \
  -H "Authorization: Bearer $DAYBOOK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "denial": "den_01JBXG2N5R8W",
    "signer": {
      "name": "Alex Biller",
      "title": "Billing Manager"
    }
  }'

Response

idstring
Unique id, prefixed apl_.
objectstring
Always appeal.
statusstring
drafting, ready or refused.
denialstring
The denial id.
letterobject
Present when ready.
Properties
- textstring
  The letter as plain text.
- pdf_urlstring
  Signed link to the PDF.
refused_reasonstring
Present when refused: why the denial should not be appealed, with the figures behind it.
created_atstring
RFC 3339 timestamp.

curl -X POST https://api.daybookhealthcare.com/v1/appeals \
  -H "Authorization: Bearer $DAYBOOK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "denial": "den_01JBXG2N5R8W",
    "signer": {
      "name": "Alex Biller",
      "title": "Billing Manager"
    }
  }'

Response 200

{
  "id": "apl_01JBXH6Q0T3Y",
  "object": "appeal",
  "status": "drafting",
  "denial": "den_01JBXG2N5R8W",
  "letter": null,
  "refused_reason": null,
  "created_at": "2026-10-29T16:00:00Z"
}