Documents

Documents are the tax invoice receipts and receipts Ching issues through the connected Glance business identity. They are generated automatically when a charge or subscription renewal succeeds.

Use cases: Surface PDF receipts in your own UI, reconcile accounting exports, or email a PDF link after payment.

GET/v1/documents

List the 100 most recent documents, newest first.

Request

curl -X GET "https://api.ching.co.il/v1/documents" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "success": true,
  "data": [
    {
      "id": "doc_R0i70cuPK_yO",
      "object": "document",
      "type": "tax_invoice_receipt",
      "status": "issued",
      "number": "1042",
      "amount": 9900,
      "currency": "ils",
      "vat_rate": 0.18,
      "vat_amount": 1510,
      "allocation_number": "REC-1042",
      "pdf_url": "https://files.ching.co.il/doc/doc_R0i70cuPK_yO.pdf",
      "sent_to_customer": true,
      "metadata": {},
      "livemode": false,
      "issued_at": "2026-04-19T09:15:25.000Z",
      "created": "2026-04-19T09:15:25.000Z"
    }
  ]
}

GET/v1/documents/:id

Retrieve a document. Older documents may have their number and pdf_url backfilled on first read.

Path Parameters

Name	Type		Description
`id`	string	required	The document id.

Request

curl -X GET "https://api.ching.co.il/v1/documents/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "success": true,
  "data": {
    "id": "doc_R0i70cuPK_yO",
    "object": "document",
    "type": "tax_invoice_receipt",
    "status": "issued",
    "number": "1042",
    "amount": 9900,
    "currency": "ils",
    "vat_rate": 0.18,
    "vat_amount": 1510,
    "allocation_number": "REC-1042",
    "pdf_url": "https://files.ching.co.il/doc/doc_R0i70cuPK_yO.pdf",
    "sent_to_customer": true,
    "metadata": {},
    "livemode": false,
    "issued_at": "2026-04-19T09:15:25.000Z",
    "created": "2026-04-19T09:15:25.000Z"
  }
}