# GET List activity logs

Lists the requests about the authenticated Store's customisers that its integrations, webhook subscriptions and API keys made, as the merchant admin's Activity page shows them: newest first by `created_at`, with the newer `id` first when two requests share a time. Requires `integrations:read`. Follow `links.next` while `pagination.has_more` is true, sending each cursor back unchanged with the same filters. Without `filter[customiser_id]`, the list has the requests of the Store's most recent integration, its most recent webhook subscription and all its API keys, and the API key requests about the Store itself. With `filter[customiser_id]`, it has the requests about that customiser by any integration, webhook subscription or API key of the Store. A customiser that is not one of the Store's matches no requests. `filter[status]=failed` keeps the requests that got a status of 400 or more, and `filter[status]=success` the ones that got a lower status. `filter[causer]` keeps the requests of one kind of principal. Each entry gives the status code and duration of the request, never the request or response itself. Activity is kept for seven days.

- Source URL: https://www.signcustomiser.com/help/api/v3-get-list-activity-logs/
- Markdown URL: https://www.signcustomiser.com/help/api/v3-get-list-activity-logs.md
- Group: Integrations
- OpenAPI for this group: https://www.signcustomiser.com/help/openapi/integrations.json
- Method: GET
- Path: /api/v3/activity-logs
- Auth: Bearer token
- Required scopes: `integrations:read`

## 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 requests about this customiser. Example: 42
- filter[status] (string, optional): Only return failed (`failed`) or successful (`success`) requests. Example: failed
- filter[causer] (string, optional): Only return requests made by this kind of principal: `api_key`, `integration` or `webhook`. Example: api_key

## cURL example

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

## Response examples

### 200 GET 200 example 1

```json
{
  "data": [
    {
      "object": "activity_log",
      "id": 88124,
      "event": "request:incoming",
      "description": "API request",
      "status_code": 200,
      "duration_ms": 148,
      "causer": {
        "kind": "api_key",
        "name": "Workshop sync",
        "last_four": "a1b2"
      },
      "storefront_page": {
        "url": "https://example.com/products/neon-sign",
        "origin": "https://example.com",
        "source": "window",
        "availability": "available",
        "captured_at": "2026-11-14T09:30:58Z"
      },
      "created_at": "2026-11-14T09:31:00Z"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null
  },
  "links": {
    "self": "https://web.signcustomiser.com/api/v3/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 integrations:read scope.",
  "required_scopes": [
    "integrations:read"
  ],
  "granted_scopes": [
    "store:read"
  ],
  "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[causer] value must be one of: api_key, integration, webhook.",
  "errors": [
    {
      "parameter": "filter[causer]",
      "code": "unsupported_value",
      "detail": "The filter[causer] value must be one of: api_key, integration, webhook.",
      "allowed_values": [
        "api_key",
        "integration",
        "webhook"
      ]
    }
  ],
  "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"
}
```
