Receipts

CRUD over previously-extracted receipts. All endpoints require read scope; mutating endpoints additionally require write.

`GET /v1/receipts/:id`

Returns a single receipt.

curl https://api.receipts.oligontech.com/v1/receipts/rcp_01HQX \
  -H "X-API-Key: $OLIGON_API_KEY"

Cursor-paginated list. The SDKs hide the cursor behind an iterator.

Name	Type	Description
`after`	ISO-8601 date	Only return receipts issued on or after this date.
`before`	ISO-8601 date	Only return receipts issued strictly before.
`type`	string	Filter by `nfe`, `invoice`, …
`status`	string	Filter by `completed`, `failed`, …
`limit`	integer	Page size, 1–200 (default 50).
`cursor`	string	Opaque token from previous response's `next_cursor`.
`metadata.<key>`	string	Match on a metadata tag (`metadata.tenant_id=tnt_x`).

{
  "data": [ { "id": "rcp_...", "status": "completed", ... } ],
  "has_more": true,
  "next_cursor": "eyJpZCI6InJjcF8..."
}

for r in client.receipts.list(after="2026-01-01", type="nfe"):
    print(r.id)

Soft-deletes a receipt. The record is removed from list responses immediately and physically purged after 30 days.

curl -X DELETE https://api.receipts.oligontech.com/v1/receipts/rcp_01HQX \
  -H "X-API-Key: $OLIGON_API_KEY"

Deletion does not refund the original extract quota usage. To restore within 30 days, contact support.