Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Query Parameters
Limits the number of objects to be returned. The limit can range between 1 and 100 items. If no limit is set, it returns 10 items.
1 <= x <= 100
Which page of results to return. The lowest value is 1
, the highest value is 99
.
1 <= x <= 99
Limit the customers to the ones that have this specific email address.
Limit the customers to the ones that are located in the specified city.
Filter customers by the name property.
Filter customers by the segment id.
Filter customers by date customer was created.
"2023-12-22T10:13:06.487Z"
Filter customers by date customer was created.
"2023-12-22T10:13:06.487Z"
Filter customers by date customer was updated last time.
"2023-12-22T10:13:06.487Z"
Filter customers by date customer was updated last time.
"2023-12-22T10:13:06.487Z"
This is a property that controls the sorting direction of the results. Sort the results using one of the filtering options, where the dash -
preceding a sorting option means sorting in a descending order.
created_at
, -created_at
, updated_at
, -updated_at
, source_id
, -source_id
A cursor for pagination. This is a date-time value that defines your place in the list based on created_at
property from the customer object. For instance, if you make a list request and receive 100 objects, ending with an object created at 2020-05-24T13:43:09.024Z
, your subsequent call can include starting_after=2020-05-24T13:43:09.024Z
in order to fetch the next page of the list.
Option | Format | Sorting |
---|---|---|
Return customers before a specific creation date | - set starting_after parameter to the breakpoint date | Sorting order is descending; the most recent dates first and least recent dates last. |
Return customers after a specific create or update date | - include the order parameter set to created_at or updated_at <br>- set starting_after to the breakpoint date | Sorting order is ascending; the least recent dates first and the most recent dates last. |
"2023-12-22T10:13:06.487Z"
Response
Returns a dictionary with customer objects. The customers are returned sorted by creation date, with the most recent customers appearing first.
Response body schema for GET v1/customers
.
The type of the object represented by JSON. This object stores information about customers in a dictionary.
Identifies the name of the attribute that contains the array of customer objects.
Contains array of customer objects.
Total number of customers.
As query results are always limited (by the limit parameter), the has_more
flag indicates if there are more records for given filter parameters. This lets you know if you can run another request (with a different end date filter) to get more records returned in the results.