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

# Search taxonomies

`GET /taxonomies/{facet}`

## Request

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

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

## Path parameters

- `facet` 'cd' | 'city' | 'cma' | 'company' | 'csd' | 'edulevels' | 'employment_type' | 'lot_career_area' | 'lot_occupation_group' | 'lot_occupation' | 'lot_specialized_occupation' | 'lot_career_area_name' | 'lot_occupation_group_name' | 'lot_occupation_name' | 'lot_specialized_occupation_name' | 'naics2' | 'naics3' | 'naics4' | 'naics5' | 'naics6' | 'noc1' | 'noc2' | 'noc3' | 'noc4' | 'noc5' | 'pr' | 'province' | 'remote_type' | 'skill_categories' | 'skill_subcategories' | 'skills' | 'title', required

## Query parameters

- `q` string
- `autocomplete` boolean
- `limit` integer
- `noc_version` 'ca_noc2021'
- `company_version` 'emsi_company'
- `area_version` 'ca_area_sgc2016' | 'ca_area_sgc2021'
- `area_ca_version` '2021.0.0' | '2016.0.0'
- `new_taxonomy_versions` true | false
- `lot_version` '6' | '7'

## Response `200`

OK

- object
  - `data` object[]
    - `id` union, required
      - integer
      - string
    - `name` string, required
    - `description` string: Taxonomy facet item description.
    - `properties` object
      - `noc2` string: Job title noc2 identifier.
      - `noc2_name` string: Job title noc2 name.
      - `singular_name` string: Job title singular name (default is plural form).
      - `skill_type` string: Skills taxonomy type (Specialized Skill, Common Skill, or Certification).
      - `parent` integer: Naics parent code.
      - `naics` string, nullable: Normalized 6-digit company naics code.
      - `duns` string: Company DUNS ID.
      - `website` string: Company website.
      - `province` string: Province a company is located in.
      - `country` string: Country a company is located in.
      - `city` string: City a company is located in.
      - `address` string: Company address.
      - `language` string, nullable: language type
      - `location` object, nullable
        - `lat` number, required
        - `lon` number, required
      - `unique_postings` integer
      - `is_software` boolean: Boolean indicating if the skill is a software skill.
    - `score` number

## Other responses

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

---

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