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

# Get segment

`GET /v1/segment/{segmentId}`

## Request

- Base URL: `https://app.aptrinsic.com`
- URL: `https://app.aptrinsic.com/v1/segment/{segmentId}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/gainsight/apis/gainsight-px-rest-api/docs/v1/segment/:segmentId/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the segment with the given id

## Path parameters

- `segmentId` string, required

## Response `200`

Success

- Segment: Segment object
  - `id` string, required
  - `name` string, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized or bad API Key
- `404`: Account not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/gainsight/apis/gainsight-px-rest-api.md) - [All operations](https://skmtc.dev/gainsight/apis/gainsight-px-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gainsight/apis/gainsight-px-rest-api/revisions/e7b197b373d8?raw)