# GET List webhook subscription activity logs

Lists the deliveries of one webhook subscription of the authenticated Store, as the merchant admin's webhook activity shows them: newest first by `created_at`, with the newer `id` first when two deliveries share a time. Requires `webhooks:read`. Follow `links.next` while `pagination.has_more` is true, sending each cursor back unchanged with the same filters. A subscription of another Store answers the same 404 as one that never existed. Each entry gives the status code and duration of the delivery, never the request or response itself. Activity is kept for seven days. `filter[customiser_id]` keeps the deliveries about one customiser. A customiser that is not one of the Store's matches no deliveries. `filter[status]=errors` keeps the deliveries that got a 4xx or 5xx status or no answer.

- Source URL: https://www.signcustomiser.com/help/api/v3-get-list-webhook-subscription-activity-logs/
- Markdown URL: https://www.signcustomiser.com/help/api/v3-get-list-webhook-subscription-activity-logs.md
- Group: Webhook subscriptions
- OpenAPI for this group: https://www.signcustomiser.com/help/openapi/webhook-subscriptions.json
- Method: GET
- Path: /api/v3/webhook-subscriptions/{webhook_id}/activity-logs
- Auth: Bearer token
- Required scopes: `webhooks:read`

## Path parameters

- webhook_id (string, required): The canonical subscription ID. Example: 1

## Query parameters

- limit (string, optional): Page size from 1 to 100. Defaults to 20. Example: 20
- cursor (string, optional): The opaque next_cursor from a previous page. Example: eyJ2IjoxfQ
- filter[customiser_id] (string, optional): Only return deliveries about this customiser. Example: 42
- filter[status] (string, optional): Only return failed deliveries (`errors`). Example: errors

## cURL example

```bash
curl https://web.signcustomiser.com/api/v3/webhook-subscriptions/1/activity-logs?limit=20&cursor=eyJ2IjoxfQ&filter%5Bcustomiser_id%5D=42&filter%5Bstatus%5D=errors \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'
```

## Response examples

### 200 GET 200 example 1

```json
{
  "data": [
    {
      "object": "activity_log",
      "id": 88125,
      "event": "request:outgoing",
      "description": "Webhook request sent",
      "status_code": 410,
      "duration_ms": 212,
      "causer": {
        "kind": "webhook",
        "name": null,
        "last_four": null
      },
      "storefront_page": {
        "url": "https://example.com/products/neon-sign",
        "origin": "https://example.com",
        "source": "window",
        "availability": "available",
        "captured_at": "2026-11-14T09:31:58Z"
      },
      "created_at": "2026-11-14T09:32:00Z"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null
  },
  "links": {
    "self": "https://web.signcustomiser.com/api/v3/webhook-subscriptions/42/activity-logs",
    "documentation": "https://www.signcustomiser.com/help/api/",
    "next": null
  },
  "meta": {
    "api_version": "v3",
    "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
  }
}
```

### 401 Missing API key

```json
{
  "type": "https://www.signcustomiser.com/help/api/problems/missing_api_key",
  "title": "Missing API key",
  "status": 401,
  "code": "missing_api_key",
  "detail": "Provide a store API key as a bearer token.",
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
```

### 403 Insufficient scope

```json
{
  "type": "https://www.signcustomiser.com/help/api/problems/insufficient_scope",
  "title": "Insufficient scope",
  "status": 403,
  "code": "insufficient_scope",
  "detail": "This operation requires the webhooks:read scope.",
  "required_scopes": [
    "webhooks:read"
  ],
  "granted_scopes": [
    "webhooks:write"
  ],
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
```

### 404 Unknown subscription

```json
{
  "type": "https://www.signcustomiser.com/help/api/problems/resource_not_found",
  "title": "Resource not found",
  "status": 404,
  "code": "resource_not_found",
  "detail": "The requested resource does not exist or does not belong to the authenticated store.",
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
```

### 422 Unsupported filter value

```json
{
  "type": "https://www.signcustomiser.com/help/api/problems/invalid_parameter",
  "title": "Invalid query parameter",
  "status": 422,
  "code": "invalid_parameter",
  "detail": "The filter[status] value must be one of: errors.",
  "errors": [
    {
      "parameter": "filter[status]",
      "code": "unsupported_value",
      "detail": "The filter[status] value must be one of: errors.",
      "allowed_values": [
        "errors"
      ]
    }
  ],
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
```

### 429 Rate limited

```json
{
  "type": "https://www.signcustomiser.com/help/api/problems/rate_limited",
  "title": "Too many requests",
  "status": 429,
  "code": "rate_limited",
  "detail": "You have exceeded the request limit for this API key.",
  "retry_after": 60,
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
```
