---
title: "Get Segment"
method: GET
path: "/3.0/segments/{segment_id}"
tags: ["segments"]
---

# Get Segment

`GET /3.0/segments/{segment_id}`

## Request

- Base URL: `https://api.mailchimp.com`
- URL: `https://api.mailchimp.com/3.0/segments/{segment_id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://login.mailchimp.com/oauth2/authorize`
    - Token URL: `https://login.mailchimp.com/oauth2/token`
- TypeScript: <https://skmtc.dev/mailchimp/apis/mailchimp-api/docs/3.0/segments/:segment_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get the metadata of a segment. If the segment is not read-only, the response also contains its definition. Read-only segments do not have a definition.

## Path parameters

- `segment_id` string, required

## Query parameters

- `fields` string[]
- `exclude_fields` string[]

## Response `200`

- object: A segment. It is an advanced segment, or a read-only segment that a different Mailchimp tool made. In this API version, Mailchimp does not change or remove existing fields, but Mailchimp can add new fields. Make sure that your client ignores fields that it does not know.
  - `created_at` string, date-time: The date and time when Mailchimp created the segment, in ISO 8601 format.
  - `definition` object: The segment definition. Read-only segments do not have a definition, so the response does not include this property for them. It contains the `match` and `conditions` that you sent, the current `schema_version`, and the `contacts` object. In the `contacts` object, each entry selects exactly one subscription status. The request body of Add Segment shows all properties of a definition.
  - `id` string, uuid: The unique ID of the segment. Do not parse or change this value. Use it exactly as you received it.
  - `list_id` string: The unique ID of the list that contains the segment.
  - `read_only` boolean: If true, you can read, count, and snapshot the segment, but you cannot update or delete it. Segments that other Mailchimp tools made, for example Google Analytics segments, are read-only. A read-only segment does not have a definition.
  - `name` string: The name of the segment.

## Other responses

- `default`: An error generated by the Mailchimp API.

---

[API](https://skmtc.dev/mailchimp/apis/mailchimp-api.md) - [All operations](https://skmtc.dev/mailchimp/apis/mailchimp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mailchimp/apis/mailchimp-api/revisions/53bf4b156855?raw)