Light Mode
List Customers
GET
/customersLast modified: 4 days ago
This endpoint lets you list all customers associated with your store and filter them using a keyword. It retrieves customers whose "mobile number"
, "email"
, or "name"
match the keyword you provide.
:::info[]
The rate limit for the customers endpoints is 500
request per 10
minutes. For more details, please visit the Rate Limiting & change log documentation page.
:::
Request
Query Params
page
integer
optional
The Pagination page number
Example:
2
date_from
string
optional
Fetch a list of customers created before a specific date
Example:
2024-12-30
date_to
string
optional
Fetch a list of customers created after a specific date
Example:
2024-12-31
Request samples
Responses
Success(200)
HTTP Code: 200
Content Type : JSONapplication/json
Data Schema
No schema defined
Example
{
"status": 200,
"success": true,
"data": [
{
"id": 2075683582,
"first_name": "Ahmed",
"last_name": "Ali",
"mobile": 777777777,
"mobile_code": "967",
"email": "[email protected]",
"urls": {
"customer": "https://shtara.com/profile",
"admin": "https://shtara.com/profiley"
},
"avatar": "https://i.ibb.co/jyqRQfQ/avatar-male.webp",
"gender": "male",
"city": "Riyadh",
"country": "السعودية",
"location": "null",
"updated_at": {
"date": "2020-04-02 22:43:26.000000",
"timezone_type": 3,
"timezone": "Asia/Riyadh"
},
"groups": [
11323141,
11323142
]
},
{
"id": 2075683581,
"first_name": "Ali",
"last_name": "Ahmed",
"mobile": 777777777,
"mobile_code": "967",
"email": "[email protected]",
"avatar": "https://i.ibb.co/jyqRQfQ/avatar-male.webp",
"gender": "male",
"city": "Riyadh",
"country": "السعودية",
"location": "null",
"updated_at": {
"date": "2020-04-02 22:43:26.000000",
"timezone_type": 3,
"timezone": "Asia/Riyadh"
},
"groups": [
11323141,
11323142
]
}
],
"pagination": {
"count": 2,
"total": 2,
"perPage": 15,
"currentPage": 1,
"totalPages": 1,
"links": []
}
}
Last modified: 4 days ago