---
title: "Get Talent Tag Definitions"
method: GET
path: "/v1/talent-tag-definitions"
tags: ["Talent"]
---

# Get Talent Tag Definitions

`GET /v1/talent-tag-definitions`

## Request

- Base URL: `https://api.avionte.com/front-office`
- URL: `https://api.avionte.com/front-office/v1/talent-tag-definitions`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Returns a list of dropdown values for the talent tag definitions from the *Tags* tab of the talent profile.

## Headers

- `RequestId` string, uuid: Unique request identifier in UUID format used to correlate request data to log entries and events.
- `FrontOfficeTenantId` integer
- `Tenant` string

## Response `200`

A list of talent tag definitions.

- TalentTagDefinitions
  - `certifications` Certification[]: A list of values for the Certification dropdown and their details.
    - `id` integer: The identifier for the certification option.
    - `name` string: The name of the certification option.
    - `frontOfficeTenantId` integer: The unique identifier that represents a client.
  - `citizenship` CitizenshipType[]: A list of values for the Citizenship dropdown and their details.
    - `id` integer: The identifier for the citizenship type option.
    - `name` string: The name of the citizenship type option.
    - `frontOfficeTenantId` integer: The unique identifier that represents a client.
  - `candidateSources` CandidateSource[]: A list of values for the Source dropdown and their details.
    - `id` integer: The identifier for the candidate Source option.
    - `name` string: The name of the candidate Source option.
    - `frontOfficeTenantId` integer: The unique identifier that represents a client.
  - `companies` CompanyExperienceOption[]: A list of values for the Company Experience dropdown and their details.
    - `id` integer: The identifier for the company experience option.
    - `name` string: The name of the company experience option.
    - `frontOfficeTenantId` integer: The unique identifier that represents a client.
  - `customTags` CustomTag[]: A list of Custom Tags and their details.
    - `categoryId` integer: The identifier for the category option.
    - `category` string: The name of the category option.
    - `detailId` integer: The identifier for the detail option.
    - `detail` string: The name of the detail option.
    - `frontOfficeTenantId` integer: The unique identifier that represents a client.
  - `industries` IndustryExperienceOption[]: A list of values for the Industry Experience dropdown and their details.
    - `id` integer: The identifier for the industry experience option.
    - `name` string: The name of the industry experience option.
    - `frontOfficeTenantId` integer: The unique identifier that represents a client.
  - `quickSearchTitles` QuickSearchTitle[]: A list of values for the QuickSearch dropdown and their details.
    - `id` integer: The identifier for the quick search title option.
    - `name` string: The name of the quick search title option.
    - `frontOfficeTenantId` integer: The unique identifier that represents a client.
  - `skills` Skill[]: A list of values for the Skill Set dropdown and their details.
    - `positionId` integer: The identifier for the position category.
    - `position` string: The name of the position category.
    - `descriptionId` integer: The identifier for the description.
    - `description` string: The description for the skill.
    - `frontOfficeTenantId` integer: The unique identifier that represents a client.
    - `talentFacing` boolean: An indication of whether a skill is visible and applicable to talent users.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Access Denied
- `404`: Not found
- `405`: Unsupported method
- `406`: Unsupported format(s) indicated by Accept header
- `415`: Unsupported format(s) indicated by the Content-Type header
- `429`: Too many requests
- `500`: An unexpected error occurred
- `502`: Service Unavailable
- `504`: Gateway Timeout

---

[API](https://skmtc.dev/avionte/apis/bold-front-office-api.md) - [All operations](https://skmtc.dev/avionte/apis/bold-front-office-api/llms.txt) - [OpenAPI document](https://skmtc.dev/avionte/apis/bold-front-office-api/revisions/bd5996cbaa0f?raw)