# List Events

> Events of the last 30 days (newest first).

Source: https://shopassist.coec.dk/docs/api/reference/events/list-events · Updated 2026-11-03

`GET /v1/events`

- Scope: `events:read`
- Rate limit: 600 requests/min per API key (test keys: 60/min)

Events of the last 30 days (newest first).

## Parameters [#parameters]

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `type` | query | `string (enum) \| null` | no |  |
| `store_id` | query | `string \| null` | no |  |
| `created_after` | query | `string \| null` | no |  |
| `limit` | query | `integer` | no | Page size |
| `cursor` | query | `string \| null` | no | Cursor from the previous page |

## Example request [#example-request]

```bash
curl -X GET "https://api.shopassist.coec.dk/v1/events" \
  -H "Authorization: Bearer $SHOPASSIST_API_KEY"
```

## Response 200 (Page_WebhookEventEnvelope_) [#response]

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | `WebhookEventEnvelope[]` | yes |  |
| `data[].api_version` | `"v1"` | yes | default "v1" |
| `data[].created_at` | `string` | yes | format date-time |
| `data[].data` | `object` | yes |  |
| `data[].id` | `string` | yes | pattern `^evt_[0-9a-hjkmnp-tv-z]{26}$` |
| `data[].organization_id` | `string` | yes | pattern `^org_[0-9a-hjkmnp-tv-z]{26}$` |
| `data[].store_id` | `string \| null` | yes | null for organization-level events (usage) · pattern `^sto_[0-9a-hjkmnp-tv-z]{26}$` |
| `data[].type` | `string (enum)` | yes | one of conversation.created, conversation.closed, message.created, handoff.requested, handoff.updated, lead.captured, lead.confirmed, lead.unsubscribed, back_in_stock.subscribed, back_in_stock.notified, csat.submitted, action.executed, order.attributed, privacy_request.completed, store.status_changed, sync.failed, usage.threshold_reached |
| `has_more` | `boolean` | yes |  |
| `next_cursor` | `string \| null` | yes | Opaque cursor for the next page; null on the last page |

```json
{
  "data": [
    {
      "api_version": "v1",
      "created_at": "2026-09-28T10:15:30.123Z",
      "data": {},
      "id": "evt_01j8000000e008000000000000",
      "organization_id": "org_01j8000000e008000000000000",
      "store_id": "sto_01j8000000e008000000000000",
      "type": "conversation.created"
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Errors [#errors]

| Status | Meaning |
| --- | --- |
| 400 | Bad Request ([error codes](/docs/api/errors)) |
| 401 | Unauthorized ([error codes](/docs/api/errors)) |
| 403 | Forbidden ([error codes](/docs/api/errors)) |
| 422 | Unprocessable Content ([error codes](/docs/api/errors)) |
| 429 | Too Many Requests ([error codes](/docs/api/errors)) |