---
title: "List Customer's Segments"
method: GET
path: "/v1/customers/{customerId}/segments"
tags: ["Customers"]
---

# List Customer's Segments

`GET /v1/customers/{customerId}/segments`

Returns the list of segments IDs to which the customer belongs to.  

If you pass a `customerId` which is not stored and recognized by Voucherify as an existing customer in the system, the response will generate a list of segments that the customer would potentialy qualify for if they were to become a customer tracked in the system.

## Response `200`

The method returns segment(s) to which the given customer belongs to.

- CustomersSegmentsListResponseBody — List of customer's segments
  - `object` string, required — The type of the object represented by JSON. This object stores information about customer segments.
  - `data_ref` string, required — Identifies the name of the JSON property that contains the array of segment IDs.
  - `data` SimpleSegment[], required — A dictionary that contains an array of segment IDs and names.
    - `id` string, required — Unique segment ID.
    - `name` string, required — Segment name.
    - `object` 'segment', required — The type of the object represented by the ID.
  - `total` integer, required — Total number of segments the customer belongs to.

---

[API](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions.md) · [All operations](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voucherifyio/voucherify-api-async-actions/revisions/4982266e0494/schema)