---
title: "Search Taxonomies"
method: GET
path: "/taxonomies/{facet}"
tags: ["Taxonomies"]
---

# Search Taxonomies

`GET /taxonomies/{facet}`

Search taxonomies using either whole keywords (relevance search) or partial keywords (autocomplete).

## Path parameters

- `facet` 'cip2' | 'cip4' | 'cip6' | 'city' | 'company' | 'company_v2' | 'county' | 'laa_metro' | 'laa_country' | 'laa_admin_area_1' | 'laa_admin_area_2' | 'lot_career_area' | 'lot_occupation' | 'lot_occupation_group' | 'lot_specialized_occupation' | 'edulevels' | 'fips' | 'msa' | 'naics2' | 'naics3' | 'naics4' | 'naics5' | 'naics6' | 'onet' | 'schools' | 'skill_categories' | 'skill_subcategories' | 'skills' | 'soc2' | 'soc3' | 'soc4' | 'soc5' | 'state' | 'title', required

## Query parameters

- `q` string
- `autocomplete` boolean
- `limit` integer
- `area_version` 'us_area_2024_3' | 'us_area_2024_4'
- `soc_version` 'soc_2021'
- `title_version` 'emsi'
- `cip_standard_version` '2020.0.0' | '2010.0.1'
- `cip_version` 'cip2010' | 'cip2020'
- `company_version` 'emsi_company'
- `onet_version` 'onet_2019'
- `naics_version` 'naics_std_2022'
- `new_taxonomy_versions` true | false
- `area_us_version` '1.0.2' | '1.0.3'
- `soc_lightcast_version` '2018.2021.0'
- `onet_standard_version` '2019.0.0'
- `lot_version` '7' | '6'

## 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` object
      - `skill_type` string — Skills taxonomy type (Specialized Skill, Common Skill, or Certification).
      - `is_software` boolean — Boolean indicating if the skill is a software skill.
      - `ipeds_id` string, nullable — IPEDS ID for an institution.
      - `singular_name` string — Job title singular name (default is plural form).
      - `location` object, nullable — City lat/lon locaiton.
        - `lat` number, required
        - `lon` number, required
      - `profiles` integer — Company's number of profiles.
      - `naics` union — Normalized 6-digit company naics code.
        - string
        - integer
      - `website` string, nullable — Company website.
      - `state` string, nullable — State a company is located in.
      - `country` string, nullable — Country of origin.
      - `city` string, nullable — City a company is located in.
      - `zip` string, nullable — Company zip code
      - `address` string, nullable — Company address.
      - `schools` string[] — Schools associated with an IPEDS id.
    - `score` number

## Other responses

- `400` — bad request
- `404` — requested resource not found

---

[API](https://skmtc.net/lightcast/apis/alumni-pathways-2-0.md) · [All operations](https://skmtc.net/lightcast/apis/alumni-pathways-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightcast/alumni-pathways-2-0/versions/fc66b9877391/schema)