API ReferenceEvents
Questa pagina è disponibile solo in inglese.
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. With a partner key and no Nembol-Account: your own events plus all your companies' (each with account_id) in one feed; account narrows it to one company.
Required scope: events:read.
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
account?string
Partner keys only. One company (acct_…).
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"
- "channel_account.updated"
- "channel_account.connected"
- "channel_account.disconnected"
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", "account_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", "number": "1011", "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", "subtotal": "string", "shipping": "string", "discount": "string", "tax": "string", "tax_remitted_by": "marketplace", "total": "19.90", "lines": [ { "id": "oline_66f0a1b2c3d4e5f6a7b8c9d0", "sku": "string", "title": "string", "quantity": 1, "price": "19.90", "product_id": "string", "variant_id": "string" } ], "buyer": { "name": "string", "email": "string", "country": "string", "address": { "line1": "string", "line2": "string", "city": "string", "zip": "string", "province": "string", "country": "string" } }, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" } } } ]}Ultimo aggiornamento il 18 ottobre 2026