List customers
Lists a business's customers
Required permissions
CUSTOMERS_READ
Query Parameters
| Name | Description |
|---|---|
cursor
|
A pagination cursor returned by a previous call to this endpoint. Provide this to retrieve the next set of results for your original query. See the Pagination guide for more information. |
sort_field
|
Indicates how Customers should be sorted. Default: |
sort_order
|
Indicates whether Customers should be sorted in ascending ( Default: |
Response Fields
| Name | Description |
|---|---|
cursor
|
A pagination cursor to retrieve the next set of results for the original query. Only present if the request succeeded and additional results are available. See the Pagination guide for more information. |
customers
|
An array of |
errors
|
Any errors that occurred during the request. |
Examples
You are viewing an old version of the API
GET
/v2/customers
cURL
- cURL
- Ruby
- Python
curl https://connect.squareup.com/v2/customers \
-H 'Square-Version: 2019-11-20' \
-H 'Authorization: Bearer ACCESS_TOKEN'
Response JSON
{
"customers": [
{
"id": "JDKYHBWT1D4F8MFH63DBMEN8Y4",
"created_at": "2016-03-23T20:21:54.859Z",
"updated_at": "2016-03-23T20:21:55Z",
"given_name": "Amelia",
"family_name": "Earhart",
"email_address": "Amelia.Earhart@example.com",
"address": {
"address_line_1": "500 Electric Ave",
"address_line_2": "Suite 600",
"locality": "New York",
"administrative_district_level_1": "NY",
"postal_code": "10003",
"country": "US"
},
"phone_number": "1-212-555-4240",
"reference_id": "YOUR_REFERENCE_ID",
"note": "a customer",
"groups": [
{
"id": "16894e93-96eb-4ced-b24b-f71d42bf084c",
"name": "Aviation Enthusiasts"
}
]
}
]
}