---
title: "Get label"
method: GET
path: "/labels/{id}"
tags: ["labels"]
---

# Get label

`GET /labels/{id}`

## Request

- Base URL: `https://api.hoorayhr.io`
- URL: `https://api.hoorayhr.io/labels/{id}`
- Auth: API key in header `authorization`

Retrieves a single resource with the given id from the service.

## Path parameters

- `id` integer, required

## Response `200`

success

- Labels
  - `id` integer: ID of the label
  - `documentCategoryId` integer, nullable: ID of the parent document category
  - `workflowCategoryId` integer, nullable: ID of the parent workflow category
  - `name` union, required: Either an object containing the translated name per locale or a simple string with name of the label. **DEPRECATION NOTICE**: The object variant (containing the translated name per locale) for labels is deprecated and will be removed in the future. Use the simple string variant instead. Switching to the new string variant can be done by providing `useTranslatedLabels=true` as query parameter.
    - string: Only for requests providing `useTranslatedLabels=true` as query parameter
    - object: Only for requests that do not provide `useTranslatedLabels=true` as query parameter
  - `type` 'ASSETS' | 'CONTRACTS' | 'DOCUMENTS' | 'EXPENSE_CLAIMS' | 'HOURS' | 'LEAVE' | 'SICK_LEAVE_PHASE' | 'TIME_TRACKING' | 'TRAVEL_EXPENSES' | 'WORKFLOWS', required: Enum of the service the label is assigned to
  - `systemCategoryType` 'car' | 'computer' | 'key' | 'tablet' | 'cell phone' | 'license' | 'fixed-term' | 'internship' | 'permanent' | 'parking costs' | 'food and drinks' | 'promotional gift' | 'office supplies' | 'cost of studies' | 'travel expenses' | 'commuting' | 'customer visit' | 'conference', nullable: System pre-defined labels get type
  - `archivedAt` string, date-time, nullable: Timestamp of label being archived
  - `createdAt` string, date-time: Creation date of the label
  - `updatedAt` string, date-time: Last updated date of the label
  - `deletedAt` string, date-time, nullable: Deleted date of the label

## Other responses

- `401`: not authenticated
- `404`: not found
- `500`: general error

---

[API](https://skmtc.dev/hoorayhr/apis/hoorayhr-api-documentation.md) · [All operations](https://skmtc.dev/hoorayhr/apis/hoorayhr-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/hoorayhr/apis/hoorayhr-api-documentation/revisions/3adcd47cd827?raw)