---
title: "Get a segment"
method: GET
path: "/api/v1/segments/{id}"
tags: ["Segments"]
---

# Get a segment

`GET /api/v1/segments/{id}`

## Request

- Base URL: `https://app.convertflow.co`
- URL: `https://app.convertflow.co/api/v1/segments/{id}`
- Auth: HTTP bearer

One visitor segment with its conditions. Requires segments:read.

## Response `200`

segment returned

- object
  - `id` integer
  - `name` string
  - `website_id` integer
  - `conditions` object[]
    - `id` integer
    - `condition_type` string
    - `operator` string
    - `keyword` string, nullable
    - `country` string, nullable
    - `url` string, nullable
    - `count` integer
    - `condition_cta` integer
    - `tag_id` unknown
    - `data` object
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `404`: segment belongs to another website

---

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