API ReferenceEvents
List events
GET /rest/v1/events
The durable event log (retained 30 days). Reconcile webhook deliveries, backfill after downtime, or skip webhooks entirely and poll this.
Authorization
apiKey AuthorizationBearer <token>
Authorization: Bearer nbl_live_... (or nbl_test_... for test mode). Test-mode writes are validated and simulated but never persisted and never touch channels; simulated results are marked simulated.
In: header
Query Parameters
limit?integer
Range
1 <= value <= 100Default
25cursor?string
type?string
New event types may be added; tolerate unknowns.
Value in
- "order.created"
- "order.status_changed"
- "product.updated"
- "product.deleted"
- "inventory.updated"
- "listing.status_changed"
- "operation.completed"
created_after?string
Format
date-timeResponse Body
application/json
curl -X GET "https://example.com/events"{ "object": "list", "has_more": true, "next_cursor": "string", "data": [ { "id": "evt_2c91d", "object": "event", "api_version": "2026-07-24", "store_id": "string", "created_at": "2019-08-24T14:15:22Z", "type": "order.created", "data": { "object": { "id": "ord_1f83b", "object": "order", "channel_account_id": "string", "channel": "string", "order_id_on_channel": "string", "order_url": "http://example.com", "status": "awaiting_payment", "fulfillment_status": "unfulfilled", "source_status": "string", "tracking": { "number": "string", "carrier": "string", "url": "http://example.com" }, "currency": "string", "total": "19.90", "lines": [ { "sku": "string", "title": "string", "quantity": 0, "price": "19.90", "product_id": "string" } ], "buyer": { "name": "string", "email": "string", "country": "string" }, "created_at": "2019-08-24T14:15:22Z" } } } ]}Last updated on July 28, 2026
Need help?
The API is in private beta — email us and a human replies, usually within one business day.