---
title: "RetrieveCustomerSegment"
method: GET
path: "/v2/customers/segments/{segment_id}"
tags: ["CustomerSegments"]
---

# RetrieveCustomerSegment

`GET /v2/customers/segments/{segment_id}`

Retrieves a specific customer segment as identified by the `segment_id` value.

## Path parameters

- `segment_id` string, required

## Response `200`

Success

- RetrieveCustomerSegmentResponse — Defines the fields that are included in the response body for requests to the `RetrieveCustomerSegment` endpoint. Either `errors` or `segment` is present in a given response (never both).
  - `errors` Error[] — Any errors that occurred during the request.
    - `category` string, required — The high-level category for the error.
    - `code` string, required — The specific code of the error.
    - `detail` string — A human-readable description of the error for debugging purposes.
    - `field` string — The name of the field provided in the original request (if any) that the error pertains to.
  - `segment` CustomerSegment — Represents a group of customer profiles that match one or more predefined filter criteria. Segments (also known as Smart Groups) are defined and created within the Customer Directory in the Square Seller Dashboard or Point of Sale.
    - `created_at` string — The timestamp when the segment was created, in RFC 3339 format.
    - `id` string — A unique Square-generated ID for the segment.
    - `name` string, required — The name of the segment.
    - `updated_at` string — The timestamp when the segment was last updated, in RFC 3339 format.

---

[API](https://skmtc.net/square/apis/squareup.md) · [All operations](https://skmtc.net/square/apis/squareup/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/square/squareup/revisions/8d95e3639487/schema)