---
title: "Lists designations"
method: GET
path: "/api/v1/designations"
tags: ["Designations"]
---

# Lists designations

`GET /api/v1/designations`

## Request

- Base URL: `https://api.flexiple.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.flexiple.com/api/v1/designations`
- Auth: one of:
  - none
  - HTTP bearer

## Query parameters

- `q` string
- `ids[]` integer[]
- `dropdown` boolean
- `include_groups` boolean
- `page` integer
- `page_size` integer

## Response `200`

Bulk label lookup is not clipped by the global pagination clamp

- object
  - `data` union[], required
    - union
      - DropdownDesignation
        - `value` integer, required
        - `label` string, required
      - DropdownEntityGroup
        - `value` integer, required
        - `label` string, required
        - `member_ids` integer[], required
      - Designation
        - `id` integer, required
        - `name` string, required
  - `meta` PaginationMeta, nullable
    - `total_count` integer
    - `total_pages` integer
    - `next_page` integer, nullable
    - `prev_page` integer, nullable
    - `current_page` integer
    - `page_size` integer

---

[API](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1.md) - [All operations](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1/revisions/27e7987859f2?raw)