Docs
API ReferenceReference

List end users

GET
/end-users

Returns the organization's end users, newest first, including anonymous visitors (authMethod tells them apart). Soft-deleted accounts are excluded.

Requires the end_users:read scope.

AuthorizationBearer <token>

An organization API key, created from a Storefront's Webhooks page (Provisioning API card). The secret is shown once at creation and stored only as a hash. Keys are organization-wide and carry scopes (end_users:read, end_users:write). Rate limit: 120 requests per minute per key (sliding 60-second window).

In: header

Query Parameters

email?string

Exact-match email filter (case-insensitive).

Formatemail
cursor?string

Opaque pagination cursor from a previous response's nextCursor.

limit?integer

Page size.

Range1 <= value <= 100
Default25

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/end-users"
{  "endUsers": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "email": "user@example.com",      "fullName": "string",      "authMethod": "string",      "emailVerifiedAt": "2019-08-24T14:15:22Z",      "revokedAt": "2019-08-24T14:15:22Z",      "lastSeenAt": "2019-08-24T14:15:22Z",      "createdAt": "2019-08-24T14:15:22Z"    }  ],  "nextCursor": "string"}