> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trypost.it/llms.txt
> Use this file to discover all available pages before exploring further.

# List labels

> List all labels for the current workspace, latest first. Returns a plain array (no pagination).

## Response

Plain array of label objects. Each item has these fields:

<ResponseField name="id" type="string">
  Label UUID.
</ResponseField>

<ResponseField name="name" type="string">
  Label name.
</ResponseField>

<ResponseField name="color" type="string">
  Hex color code in `#RRGGBB` format (e.g. `#4f46e5`).
</ResponseField>

<ResponseField name="created_at" type="string">
  Creation timestamp in `Y-m-d H:i:s` format.
</ResponseField>

<ResponseField name="updated_at" type="string">
  Last update timestamp in `Y-m-d H:i:s` format.
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl -X GET https://app.trypost.it/api/labels \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  [
    {
      "id": "c3d4e5f6-a7b8-9c0d-1e2f-3a4b5c6d7e8f",
      "name": "Product Launch",
      "color": "#4f46e5",
      "created_at": "2025-01-10 08:00:00",
      "updated_at": "2025-01-10 08:00:00"
    },
    {
      "id": "f6a7b8c9-d0e1-2f3a-4b5c-6d7e8f9a0b1c",
      "name": "Urgent",
      "color": "#ef4444",
      "created_at": "2025-01-12 14:00:00",
      "updated_at": "2025-01-12 14:00:00"
    }
  ]
  ```
</ResponseExample>