Integrations
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.
Overview
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.
Authorisation
Bearer token required. Include it in the Authorization header.
Required scope: integrations:read
Path parameters
The integration id, from the list integrations operation.
Example: 12
Query parameters
Page size from 1 to 100. Defaults to 20.
Example: 20
The opaque next_cursor from a previous page.
Example: eyJ2IjoxfQ
Only return requests about this customiser.
Example: 42
Only return errors (`errors`) or errors that need action (`actionable_errors`).
Example: errors
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'{
"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"
}
}{
"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"
}{
"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"
}{
"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"
}{
"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"
}{
"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"
}