Webhooks API

Manage webhook endpoints and inspect past deliveries. For the high-level concept and verification code, see Concepts → Webhooks.

`GET /v1/webhooks/events`

Cursor-paginated history of delivered (or attempted) events. Useful for debugging failed deliveries and re-driving from any point.

Query parameters

Name	Type	Description
`type`	string	Filter to one event type (`receipt.completed`, …).
`limit`	integer	1–200 (default 50).
`cursor`	string	Pagination token.

Example

curl "https://api.receipts.oligontech.com/v1/webhooks/events?type=receipt.completed&limit=10" \
  -H "X-API-Key: $OLIGON_API_KEY"

Response

{
  "data": [
    {
      "id": "evt_01HQX...",
      "type": "receipt.completed",
      "org_id": "org_01HQX...",
      "created_at": "2026-06-08T14:32:11Z",
      "data": { "receipt": { "id": "rcp_...", "total": "47.50" } }
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Endpoints (CRUD via portal)

Webhook endpoint CRUD lives in the portal under Settings → Webhooks (opens in a new tab). The API surface is intentionally minimal — we have not seen demand for it yet. If you do need it, open an issue (opens in a new tab).

Receipts Authentication