Skip to content

Latest commit

 

History

History
59 lines (49 loc) · 1.85 KB

list-customers-response.md

File metadata and controls

59 lines (49 loc) · 1.85 KB
Raw

List Customers Response

Defines the fields that are included in the response body of a request to the ListCustomers endpoint.

Either errors or customers is present in a given response (never both).

Structure

ListCustomersResponse

Fields

Name Type Tags Description
errors Error[] | undefined Optional Any errors that occurred during the request.
customers Customer[] | undefined Optional An array of Customer objects that match the provided query.
cursor string | undefined Optional A pagination cursor to retrieve the next set of results for the
original query. A cursor is only present if the request succeeded and additional results
are available.

For more information, see Pagination.

Example (as JSON)

{
  "customers": [
    {
      "address": {
        "address_line_1": "500 Electric Ave",
        "address_line_2": "Suite 600",
        "administrative_district_level_1": "NY",
        "country": "US",
        "locality": "New York",
        "postal_code": "10003"
      },
      "created_at": "2016-03-23T20:21:54.859Z",
      "creation_source": "THIRD_PARTY",
      "email_address": "[email protected]",
      "family_name": "Earhart",
      "given_name": "Amelia",
      "group_ids": [
        "545AXB44B4XXWMVQ4W8SBT3HHF"
      ],
      "id": "JDKYHBWT1D4F8MFH63DBMEN8Y4",
      "note": "a customer",
      "phone_number": "1-212-555-4240",
      "preferences": {
        "email_unsubscribed": false
      },
      "reference_id": "YOUR_REFERENCE_ID",
      "segment_ids": [
        "1KB9JE5EGJXCW.REACHABLE"
      ],
      "updated_at": "2016-03-23T20:21:55Z",
      "version": 1
    }
  ]
}