Integration API · Customers

List customers

GEThttps://{store}/api/v1/integrations/customers

Customer accounts of the store in id order, with cursor pagination like orders. updated_since picks up changes since your last sync.

customers:read gives personal data: issue it only to systems that need it. New sign-ups also arrive as the customer.created webhook.

Integration key with the customers:read ability: Authorization: Bearer {key}.

Query parameters

updated_sincestring

Only customers updated at or after this time (YYYY-MM-DD HH:MM:SS).

cursorinteger

Return customers with an id greater than this.

limitinteger

Page size. Default 15, maximum 50.

Responses

200A page of customers and the next cursor.

{
    "data": [
        {
            "id": 318,
            "first_name": "Олена",
            "last_name": "Коваль",
            "company_name": null,
            "email": "[email protected]",
            "orders_count": 3,
            "created_at": "2026-09-14 11:02:40",
            "updated_at": "2026-10-12 14:03:11"
        }
    ],
    "next_cursor": null
}

401Missing, unknown or revoked key.

{
    "code": "unauthenticated",
    "message": "Integration key is inactive.",
    "field": null
}

403The key lacks customers:read, or the store’s plan has no API access.

{
    "code": "forbidden",
    "message": "Integration key cannot customers:read.",
    "field": null
}

422A field is invalid; field names it.

{
    "code": "validation_error",
    "message": "name is required.",
    "field": "name"
}

429More than 60 requests a minute for this key. Wait Retry-After seconds.

{
    "code": "rate_limited",
    "message": "Too many integration requests.",
    "field": null
}