# GET Get a customiser's customer activity

Returns when shoppers last used the customiser and how, the pages it was last seen on (as the shopper's browser reported them, so treat them as untrusted text), its published languages and when its configuration last changed. `status` is `live` for activity in the last hour, `recent` for the last 7 days, `quiet` for older activity and `none` for none. Read-only; requires `customisers:read`. A 404 problem means the customiser is not one of this store's.

- Source URL: https://www.signcustomiser.com/help/api/v3-get-get-a-customiser-s-customer-activity/
- Markdown URL: https://www.signcustomiser.com/help/api/v3-get-get-a-customiser-s-customer-activity.md
- Group: Customisers
- OpenAPI for this group: https://www.signcustomiser.com/help/openapi/customisers.json
- Method: GET
- Path: /api/v3/customisers/{customiser_id}/customer-activity
- Auth: Bearer token
- Required scopes: `customisers:read`

## Path parameters

- customiser_id (string, required): The customiser id. Example: 1

## cURL example

```bash
curl https://web.signcustomiser.com/api/v3/customisers/1/customer-activity \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'
```

## Response examples

### 200 GET 200 example 1

```json
{
  "data": {
    "object": "customiser_customer_activity",
    "customiser_id": 42,
    "status": "recent",
    "last_activity": {
      "type": "add_to_cart",
      "at": "2026-11-15T18:20:00Z"
    },
    "seen_on": [
      "https://example.com/products/neon-sign"
    ],
    "languages": [
      {
        "language_code": "en",
        "display_name": "English",
        "is_default": true
      }
    ],
    "last_changed_at": "2026-11-14T08:00:00Z"
  },
  "links": {
    "self": "https://web.signcustomiser.com/api/v3/customisers/42/customer-activity",
    "documentation": "https://www.signcustomiser.com/help/api/"
  },
  "meta": {
    "api_version": "v3",
    "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 customisers:read scope.",
  "required_scopes": [
    "customisers:read"
  ],
  "granted_scopes": [
    "store:read"
  ],
  "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
```
