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

# List labels

`GET /labels`

## Request

- Base URL: `https://api.streamtime.net/v2`
- URL: `https://api.streamtime.net/v2/labels`
- Auth: HTTP bearer

Lists master labels for a label type or labels for a specific entity when entity_id is provided.

## Query parameters

- `label_type_id` integer, required
- `entity_id` integer, nullable

## Response `200`

Labels fetched successfully.

- union
  - MasterLabel[]
    - `id` integer: The ID of the master label
    - `name` string: Label name
    - `labelType` LabelType: What the label will be attached to.
      - `id` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8: Label type ID (1=Job, 2=Quote, 3=Invoice, 4=Logged Expense, 5=Company, 6=Contact, 7=User, 8=Job Group)
      - `name` string
  - Label[]
    - `id` integer: Label ID
    - `name` string: Label name
    - `entityId` integer: ID of the entity this label is attached to
    - `labelType` LabelType: What the label will be attached to.
      - `id` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8: Label type ID (1=Job, 2=Quote, 3=Invoice, 4=Logged Expense, 5=Company, 6=Contact, 7=User, 8=Job Group)
      - `name` string

---

[API](https://skmtc.dev/streamtime/apis/public-api.md) · [All operations](https://skmtc.dev/streamtime/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/streamtime/apis/public-api/revisions/cda8d1405534?raw)