---
title: "Get Segment"
method: GET
path: "/v1/segments/{segmentId}"
tags: ["Segments"]
---

# Get Segment

`GET /v1/segments/{segmentId}`

Retrieves the segment with a given segment ID.

This method doesn't return the customers that belong to the segment. To return a list of customers who belong to a segment, use [GET List customers](/api-reference/customers/list-customers) endpoint with the `segment_id` query parameter.

## Response `200`

Returns segment object.

- SegmentsGetResponseBody — This is an object representing a customer segment.
  - `id` string — Unique segment ID.
  - `name` string — Segment name.
  - `created_at` string, date-time — Timestamp representing the date and time when the segment was created. The value is shown in the ISO 8601 format.
  - `updated_at` string, date-time — Timestamp in ISO 8601 format indicating when the segment was updated.
  - `type` 'auto-update' | 'passive' | 'static' — Defines whether the segment is: - Active (`auto-update`): customers enter and leave the segment based on the defined filters and the `customer.segment.entered` and `customer.segment.left` events are triggered, - Passive (`passive`): customers enter and leave the segment based on the defined filters, but the `customer.segment.entered` and `customer.segment.left` events are not triggered, - Static (`static`): manually selected customers.
  - `filter` object, nullable — Defines a set of criteria for an `auto-update` or `passive` segment type.
  - `object` 'segment' — The type of the object represented by JSON. This object stores information about the customer segment.

## Other responses

- `404` — Returns an error when requesting a segment that has been deleted or does not exist.

---

[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)