Skip to content

AppListCustomers

GET
/apps/customers
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.

skip
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
take
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
search
string
status
string
tag
string
updatedSince
string format: date-time

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
/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/
orderCount
required
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
personalDataRedacted
required
boolean
phone
required
null | string
tags
required
Array<string>
skip
required
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
take
required
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
total
required
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
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
}