Saltar al contenido

Events

Events

Every webhook event Tablezio has emitted is persisted here, along with the per-endpoint delivery history. Useful for debugging webhooks or replaying a missed event.

List events

GET /v1/events Scope: events:read

Every event Tablezio has emitted on behalf of this restaurant, including delivery attempts. Useful for debugging webhooks and for replaying past activity into a new system.

Query parameters

limitintegerOptional

Page size.

starting_afterstringOptional

Cursor.

typestringOptional

Filter by event type (e.g. order.created).

Request

curl 'https://api.tablezio.com/v1/events?type=order.cancelled' -H 'X-API-Key: tbz_…'

Response

application/json
{ "object": "list", "data": [ /* event */ ], "has_more": true, "next_cursor": "…", "previous_cursor": null, "url": "/v1/events" }

Retrieve an event

GET /v1/events/{id} Scope: events:read

Fetch a single event including its delivery history per endpoint.

Path parameters

idstringRequired

Event ID (evt_…).

Request

curl https://api.tablezio.com/v1/events/evt_… -H 'X-API-Key: tbz_…'

Response

application/json
{
  "id": "evt_8b2c3d4e5f6a7b8c9d0e1f20",
  "object": "event",
  "created": 1716730000,
  "type": "order.created",
  "livemode": true,
  "status": "delivered",
  "data": { "object": { /* the full resource at the time of the event */ } },
  "deliveries": [
    {
      "endpoint": "we_…",
      "url": "https://example.com/webhooks/tablezio",
      "status": "delivered",
      "delivered_at": 1716730005,
      "next_retry_at": null,
      "attempts": [
        { "attempted_at": 1716730005, "response_status": 200, "duration_ms": 142, "error": null, "succeeded": true }
      ]
    }
  ]
}