# Retrieve list of segments

Retrieve a list of segments.

Endpoint: GET /audiences/{audienceId}/segments
Version: 1.0.0
Security: TdApikeyAuth

## Path parameters:

  - `audienceId` (integer, required)
    Master Segment id of the segment

## Response 200 fields (application/json):

  - `audienceId` (string)

  - `id` (string)

  - `name` (string)

  - `kind` (integer)
    0: batch, 1: realtime, 2: funnel_stage

  - `description` (string,null)

  - `segmentFolderId` (string)

  - `population` (integer,null)

  - `createdAt` (string)

  - `updatedAt` (string)

  - `createdBy` (object)

  - `createdBy.td_user_id` (string)

  - `updatedBy` (object)

  - `rule` (any)

  - `realtime` (boolean)
    Whether the segment is realtime segment or not

## Response 400 fields (application/json):

  - `code` (string, required)

  - `message` (string, required)

## Response 401 fields (application/json):

  - `code` (string, required)

  - `message` (string, required)

## Response 403 fields (application/json):

  - `code` (string, required)

  - `message` (string, required)

## Response 404 fields (application/json):

  - `code` (string, required)

  - `message` (string, required)

## Response 4XX fields (application/json):

  - `code` (string, required)

  - `message` (string, required)

## Response 5XX fields (application/json):

  - `status` (integer, required)
    Error status

  - `error` (string, required)
    Error message

  - `details` (string)
    Detailed error message