---
title: "Get segment model for specified id"
method: GET
path: "/v1/segments/{id}"
tags: ["segment"]
---

# Get segment model for specified id

`GET /v1/segments/{id}`

This endpoint retrieves the segment object for the specified segment ID.

## Path parameters

- `id` string, required

## Response `200`

The segment object for requested id.

- V1GetSegmentResponse
  - `segment` V1Segment, required
    - `id` string
    - `segmentId` string — The identifier of the segment.
    - `sourceId` string — The identifier the source where the segment came from.
    - `name` string — The name of the campaign.
    - `description` string — Meaningful description of the segment.
    - `category` string[] — The category to which segment belongs.
    - `retailerTeamId` string — The identifier of the retailer that owns the segment.

## Other responses

- `400` — There was a problem with input.
- `401` — Login failed or token not valid.
- `403` — Login failed or token not valid.
- `404` — Segment for specified id does not exist.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/citrusad/apis/citrus-auth-api.md) · [All operations](https://skmtc.net/citrusad/apis/citrus-auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/citrusad/citrus-auth-api/revisions/a040003c7378/schema)