---
title: "Get Service Metadata"
method: GET
path: "/meta"
tags: ["Meta"]
---

# Get Service Metadata

`GET /meta`

## Request

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

Get service metadata, including taxonomies, available months of data, facets, metrics, and attribution text. Caching is encouraged, but the metadata does change monthly.

## Query parameters

- `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, required
    - `available_months` string[], required
    - `attribution` object, required
      - `title` string, required
      - `body` string, required
    - `facets` string[], required
    - `filters` string[], required
    - `postingFields` string[], required
    - `latest_day` string, required
    - `metrics` string[], required
    - `supportsAdvancedFilters` boolean, required
    - `taxonomies` object, required
      - `area` string
      - `naics` string
      - `noc` string
      - `skills` string
      - `title` string
      - `company` string
      - `lot` string
      - `language` string
      - `area_ca` string
      - `companies` string
      - `canoc_lightcast` string
      - `naics_standard` string
      - `titles` string
    - `taxonomy_versions` object
      - `company` string[]
      - `noc` string[]
      - `area` string[]
      - `language` string[]
      - `area_ca` string[]
      - `lot` string[]
    - `distributionFacets` string[], required
    - `pipelineVersion` string, required

## Other responses

- `400`: bad request

---

[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)