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

# POST /taxonomies/{facet}/lookup

`POST /taxonomies/{facet}/lookup`

## Request

- Base URL: `api.lightcast.io/jpa` (relative, and the document’s source URL is not known)
- URL: `api.lightcast.io/jpa/taxonomies/{facet}/lookup`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.emsicloud.com/connect/token` scopes: `postings:us`

Look up taxonomy items by ID.

## Path parameters

- `facet` 'city' | 'cip2' | 'cip4' | 'cip6' | 'company' | 'county' | 'edulevels' | 'employment_type' | 'fips' | 'lot_career_area' | 'lot_occupation_group' | 'lot_occupation' | 'lot_specialized_occupation' | 'msa' | 'msa_skill_cluster' | 'naics2' | 'naics3' | 'naics4' | 'naics5' | 'naics6' | 'national_skill_cluster' | 'onet' | 'remote_type' | 'skill_categories' | 'skill_subcategories' | 'skills' | 'soc2' | 'soc3' | 'soc4' | 'soc5' | 'state' | 'state_skill_cluster' | 'title', required

## Query parameters

- `soc_version` 'soc_2021' | 'soc_emsi_2019'
- `onet_version` 'onet_2019' | 'onet_2010'
- `title_version` 'emsi'
- `company_version` 'emsi_company'
- `naics_version` 'naics_std_2022'
- `new_taxonomy_versions` true | false
- `soc_lightcast_version` '2010.2019.0' | '2018.2021.0'
- `onet_standard_version` '2019.0.0' | '2010.0.0'

## 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.
    - `description` string: Taxonomy facet item description.
    - `properties` Properties (unresolved $ref)

## Other responses

- `400`: Your request wasn't valid (bad parameter names or values).
- `404`: The facet you requested wasn't found.
- `500`: The service is not healthy (e.g. can't connect to datastore).

---

[API](https://skmtc.dev/lightcast/apis/chaetest.md) - [All operations](https://skmtc.dev/lightcast/apis/chaetest/llms.txt) - [OpenAPI document](https://skmtc.dev/lightcast/apis/chaetest/revisions/89fbbbbd2b7f?raw)