List customer segments

GET

/v2/customers/segments

Retrieves the list of customer segments of a business.

Permissions:CUSTOMERS_READ

Guide

List customer segments

Try in API Explorer

Link to section

Query parameters

Example code

Link to section

cursor

string

A pagination cursor returned by previous calls to ListCustomerSegments. This cursor is used to retrieve the next set of query results.

For more information, see Pagination.

Link to section

limit

integer(32-bit)

The maximum number of results to return in a single page. This limit is advisory. The response might contain more or fewer results. The limit is ignored if it is less than 1 or greater than 50. The default value is 50.

For more information, see Pagination.

Link to section

Response fields

Link to section

errors

Any errors that occurred during the request.

Link to section

segments

The list of customer segments belonging to the associated Square account.

Link to section

cursor

string

A pagination cursor to be used in subsequent calls to ListCustomerSegments to retrieve the next set of query results. The cursor is only present if the request succeeded and additional results are available.

For more information, see Pagination.

Link to section

Examples

All versions ->

GET /v2/customers/segments

curl https://connect.squareup.com/v2/customers/segments \
  -H 'Square-Version: 2021-08-18' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json'

Response JSON

{
  "segments": [
    {
      "id": "GMNXRZVEXNQDF.CHURN_RISK",
      "name": "Lapsed",
      "created_at": "2020-01-09T19:33:24.469Z",
      "updated_at": "2020-04-13T21:47:04Z"
    },
    {
      "id": "GMNXRZVEXNQDF.LOYAL",
      "name": "Regulars",
      "created_at": "2020-01-09T19:33:24.486Z",
      "updated_at": "2020-04-13T21:47:04Z"
    },
    {
      "id": "GMNXRZVEXNQDF.REACHABLE",
      "name": "Reachable",
      "created_at": "2020-01-09T19:33:21.813Z",
      "updated_at": "2020-04-13T21:47:04Z"
    },
    {
      "id": "gv2:KF92J19VXN5FK30GX2E8HSGQ20",
      "name": "Instant Profile",
      "created_at": "2020-01-09T19:33:25Z",
      "updated_at": "2020-04-13T23:01:03Z"
    }
  ]
}

List customer segments

Query parameters

Response fields

Strictly necessary technology

Performance and analytical technology

Functionality technology

Retargeting or advertising technology