AppListCustomers
GET
/apps/customers
const url = 'https://your-store.myciqra.com/apps/customers';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://your-store.myciqra.com/apps/customers \ --header 'Authorization: Bearer <token>'Required scope: read_customers — an installation token without it receives 403.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”skip
integer | string format: int32
take
integer | string format: int32
search
string
status
string
tag
string
updatedSince
string format: date-time
Responses
Section titled “Responses”OK
Media typeapplication/json
object
hasMore
required
boolean
items
required
Array<object>
object
acceptsMarketing
required
boolean
city
required
null | string
countryCode
required
null | string
createdAt
required
string format: date-time
currency
required
null | string
email
required
null | string
firstName
required
null | string
id
required
string format: uuid
isActive
required
boolean
lastName
required
null | string
lastOrderAt
required
null | string format: date-time
lifetimeSpend
required
number | string format: double
orderCount
required
integer | string format: int32
personalDataRedacted
required
boolean
phone
required
null | string
tags
required
Array<string>
skip
required
integer | string format: int32
take
required
integer | string format: int32
total
required
integer | string format: int32
Examplegenerated
{ "hasMore": true, "items": [ { "acceptsMarketing": true, "city": "example", "countryCode": "example", "createdAt": "2026-04-15T12:00:00Z", "currency": "example", "email": "example", "firstName": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "isActive": true, "lastName": "example", "lastOrderAt": "2026-04-15T12:00:00Z", "lifetimeSpend": 1, "orderCount": 1, "personalDataRedacted": true, "phone": "example", "tags": [ "example" ] } ], "skip": 1, "take": 1, "total": 1}