# GET List integration activity logs

Lists the requests one integration of the authenticated Store sent or received, as the merchant admin's integration activity 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. An integration of another Store answers the same 404 as one that never existed. Each entry gives the status code and duration of the request, never the request or response itself. Activity is kept for seven days. `filter[customiser_id]` keeps the requests about one customiser. A customiser that is not one of the Store's matches no requests. `filter[status]=errors` keeps the requests that got a 4xx or 5xx status. `filter[status]=actionable_errors` also leaves out the errors that are expected and need no action.

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

## Path parameters

- integration_id (string, required): The integration id, from the list integrations operation. Example: 12

## 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 errors (`errors`) or errors that need action (`actionable_errors`). Example: errors

## cURL example

```bash
curl https://web.signcustomiser.com/api/v3/integrations/12/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": 88123,
      "event": "request:outgoing",
      "description": "Outgoing request",
      "status_code": 502,
      "duration_ms": 1840,
      "causer": {
        "kind": "integration",
        "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:29:58Z"
      },
      "created_at": "2026-11-14T09:30:00Z"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null
  },
  "links": {
    "self": "https://web.signcustomiser.com/api/v3/integrations/12/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"
}
```

### 404 Unknown integration

```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, actionable_errors.",
  "errors": [
    {
      "parameter": "filter[status]",
      "code": "unsupported_value",
      "detail": "The filter[status] value must be one of: errors, actionable_errors.",
      "allowed_values": [
        "errors",
        "actionable_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"
}
```
