---
title: "GET a Segment's Details"
method: GET
path: "/segments/{segment_id}"
tags: ["Segments"]
---

# GET a Segment's Details

`GET /segments/{segment_id}`

Use this method to get details about a segment, including the segment criteria. If you know the `segment_id` You can also use this method to get details about a deleted segment. For more use case information, see [Get a Segment's Details](/api_guide/segment_get.html) in the API guide.

## Path parameters

- `segment_id` integer, required

## Response `200`

The segment was successfully returned.

- SegmentDetail
  - `name` string — The segment's unique descriptive name.
  - `segment_criteria` string — The segment's contact selection criteria formatted as single-string escaped JSON.
  - `segment_id` integer — The system generated number that uniquely identifies the segment.
  - `created_at` string, date-time — The system generated date and time (ISO-8601) that the segment was created.
  - `edited_at` string, date-time — The system generated date and time (ISO-8601) that the segment's <code>name</code> or <code> segment_criteria</code> was last updated.

## Other responses

- `400` — Bad request. Either the JSON was malformed or there was a data validation error.
- `401` — The Access Token used is invalid.
- `404` — The requested resource was not found.
- `415` — Unsupported Media Type.
- `500` — There was a problem with our internal service.

---

[API](https://skmtc.net/cc/apis/appconnect-v3.md) · [All operations](https://skmtc.net/cc/apis/appconnect-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cc/appconnect-v3/versions/4b4a534c818d/schema)