---
title: "Lookup taxonomy items by ID"
method: POST
path: "/taxonomies/{facet}/lookup"
tags: ["Taxonomies"]
---

# Lookup taxonomy items by ID

`POST /taxonomies/{facet}/lookup`

## Request

- Base URL: `https://api.lightcast.io/uk-profiles`
- URL: `https://api.lightcast.io/uk-profiles/taxonomies/{facet}/lookup`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.emsicloud.com/connect/token` scopes: `profiles:uk`

Lookup taxonomy items by ID.

## Path parameters

- `facet` 'city' | 'company' | 'gender' | 'schools' | 'skills' | 'title' | 'lot_specialized_occupation' | 'lot_career_area' | 'lot_occupation' | 'lot_occupation_group', required

## Query parameters

- `uksoc_standard_version` '2020.0.0' | '2010.0.0'
- `soc_version` 'uk_soc2010emsi' | 'uk_soc_2020'
- `title_version` 'emsi'
- `company_version` 'emsi_company'
- `lot_version` string
- `newTaxonomyVersions` true | false

## Request body

- object
  - `ids` union[], required: Invalid IDs will be dropped. Maximum number of ids: `10000`
    - union
      - string
      - integer

## Response `200`

OK

- object
  - `data` object[], required
    - `id` union, required: Taxonomy facet item identifier.
      - integer
      - string
    - `name` string, required: Taxonomy facet item name.
    - `properties` object
      - `country` string, nullable: Country of origin.
      - `location` object: City lat/lon locaiton.
        - `lat` number, required
        - `lon` number, required
      - `profiles` integer: The number of profiles associated with a company
      - `skill_type` string: Skills taxonomy type (Specialized Skill, Common Skill, or Certification).

## Other responses

- `400`: Your request wasn't valid (bad parameter names or values).
- `404`: The facet you requested wasn't found.

---

[API](https://skmtc.dev/lightcast/apis/profiles-uk.md) - [All operations](https://skmtc.dev/lightcast/apis/profiles-uk/llms.txt) - [OpenAPI document](https://skmtc.dev/lightcast/apis/profiles-uk/revisions/562d83d43ab7?raw)