---
title: "List Labels"
method: GET
path: "/labels"
tags: ["Labels"]
---

# List Labels

`GET /labels`

## Request

- Base URL: `https://secure.fleetio.com/api`
- URL: `https://secure.fleetio.com/api/labels`
- Auth: API key in header `Authorization` and API key in header `Account-Token`
- TypeScript: <https://skmtc.dev/fleetio/apis/fleetio-developer-api/docs/labels/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of Labels belonging to your account.

## Query parameters

- `start_cursor` string
- `per_page` integer
- `filter` object
  - `name` union
    - object
      - `like` string, required
    - object
      - `eq` string, required
- `sort` object
  - `id` 'asc' | 'desc'

## Response `200`

OK

- object
  - `start_cursor` string, nullable: The current start cursor of the records returned.
  - `next_cursor` string, nullable: The next cursor to retrieve the next page of records.
  - `per_page` integer: The maximum number of records returned.
  - `estimated_remaining_count` integer: The number of remaining records including the returned records, up to a maximum of 500.
  - `filtered_by` object[]: The filters applied to the returned record set.
    - `name` union
      - object
        - `like` string, required
      - object
        - `eq` string, required
  - `sorted_by` object[]: The sorts applied to the returned record set.
    - `id` 'asc' | 'desc'
  - `records` Label[]
    - `id` integer, required
    - `account_id` integer, required
    - `name` string, required: The name of the Label. This is the value used to tag a record.
    - `taggings_count` integer, required: The number of records that have been tagged with this Label.
    - `color` string, required: The hex color of the Label.

## Other responses

- `401`: Request could not be authenticated
- `500`: Something unexpected happened

## Changes

- **2026-11-06** `49558d744bd7`: 2 breaking, 5 info
  - the `filtered_by/items/` response's property type changed from no type to `object` for status `200`
  - the `sorted_by/items/` response's property type changed from no type to `object` for status `200`
  - for the `query` request parameter `per_page`, the min was decreased from `2.00` to `1.00`
  - added the optional property `filtered_by/items/name` to the response with the `200` status
  - …3 more

[Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/labels/get.md)

---

[API](https://skmtc.dev/fleetio/apis/fleetio-developer-api.md) - [All operations](https://skmtc.dev/fleetio/apis/fleetio-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fleetio/apis/fleetio-developer-api/revisions/49558d744bd7?raw)