---
title: "Look up taxonomies"
method: POST
path: "/taxonomies/{facet}/lookup"
tags: ["Taxonomies"]
---

# Look up taxonomies

`POST /taxonomies/{facet}/lookup`

## Request

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

Look up taxonomy items by ID.

## Path parameters

- `facet` 'company' | 'market' | 'nation' | 'occupation' | 'skills' | 'title' | 'currency' | 'laa_country' | 'laa_admin_area_1' | 'laa_admin_area_2' | 'laa_metro' | 'isco_1' | 'isco_2' | 'isco_3' | 'isco_4' | 'nace_1' | 'nace_2' | 'lot_specialized_occupation' | 'lot_occupation' | 'lot_occupation_group' | 'lot_career_area' | 'skill_categories' | 'skillsubcategories' | 'remote_type' | 'isced' | 'anz_sco_1' | 'anz_sco_2' | 'anz_sco_3' | 'anz_sco_4' | 'anz_sco_5' | 'anz_sic_1' | 'anz_sic_2' | 'anz_sic_3' | 'anz_sic_4', required

## Query parameters

- `lot_version` '6' | '7'
- `area_version` 'lf_area_2023_2' | 'lf_area_2025_1'
- `area_laa_version` '1' | '2'
- `new_taxonomy_versions` 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
      - `location` object
        - `lat` number, required
        - `lon` number, required
      - `unique_postings` integer: The number of unique postings.
      - `skill_type` string: Skills taxonomy type (Specialized Skill, Common Skill, or Certification).
      - `is_software` boolean: Boolean indicating if the skill is a software skill.
      - `singular_name` string: Job title singular name (default is plural form).
      - `exchange_rate` number, nullable: Exchange rate between the currency and USD.
      - `symbol` string: Currency symbol.
      - `parent` union: Naics parent code.
        - integer
        - string
      - `naics` union: Normalized 6-digit company naics code.
        - string
        - integer

## Other responses

- `400`: bad request
- `401`: unauthorized request
- `404`: requested resource not found

---

[API](https://skmtc.dev/lightcast/apis/job-postings-global.md) - [All operations](https://skmtc.dev/lightcast/apis/job-postings-global/llms.txt) - [OpenAPI document](https://skmtc.dev/lightcast/apis/job-postings-global/revisions/5693ebb05545?raw)