> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cometly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# get_segment

> Single segment's definition (conditions, last refresh, size).

## Parameters

| Parameter    | Type    | Required | Description                         |
| ------------ | ------- | -------- | ----------------------------------- |
| `segment_id` | integer | Yes      |                                     |
| `format`     | string  | No       | `json` (default), `csv`, or `yaml`. |

## Output

Full row from `contact_segments` including the criteria JSON, last refresh timestamp, and member count.

Returns `[not_found]` when the segment doesn't exist or segment infrastructure isn't enabled.