# Get segments

Get all segments optionally filtered by supplier

Endpoint: GET /v2/segments
Version: 2
Security: bearer

## Query parameters:

  - `supplier_id` (string)
    Filter by supplier ID

  - `limit` (number)
    Maximum number of segments to return

  - `next_token` (string)
    Token received from a previous request to obtain the next chunk of data

  - `sortBy` (array)
    Fields to sort by

  - `sortDirection` (array)
    Sort direction (1 for asc, -1 for desc)

## Response 200 fields (application/json):

  - `id` (string, required)
    Segment unique identifier

  - `segment_name` (string, required)
    Segment name

  - `assets` (array, required)
    Array of assets (domains, IPs, etc.)

  - `business_information` (array,null, required)

  - `business_information.type` (string, required)
    Enum: "text", "date", "dropDown", "multiSelection", "file"

  - `business_impact` (number, required)
    Business impact rating (1-5)

  - `portfolios` (array, required)
    Array of portfolio IDs

  - `tags` (array)
    Array of tag IDs

  - `relationships` (array, required)
    Relationship types

  - `contacts` (array)

  - `approval` (string, required)
    Approval status

  - `evaluation_type` (string, required)
    Enum: "Continuous 360 Evaluation", "Continuous Posture Evaluation", "Bi-Annual 360 Evaluation", "Bi-Annual Posture Evaluation", "Smart Questionnaires", "Inventory", "Monitoring", "Assessment", "Inventory Plus", "None"

  - `latest_assessment_date` (string)
    Latest assessment date in ISO 8601 GMT format

  - `created_by` (string, required)
    User who created the segment

  - `risk` (number,null, required)
    Risk level

  - `combined_score` (number,null, required)
    Combined risk score

  - `posture_score` (number,null, required)
    Posture assessment score

  - `questionnaire_overall_score` (object, required)
    Overall questionnaire score


## Response 204 fields

## Response 401 fields

## Response 403 fields

## Response 429 fields