---
title: "Get service metadata"
method: GET
path: "/meta"
tags: ["Meta"]
---

# Get service metadata

`GET /meta`

## Request

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

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

- `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'
- `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
      - `soc` string
      - `cip` string
      - `onet` string
      - `skills` string, required
      - `title` string
      - `company` string
      - `lot` string, required
      - `area_us` string
      - `cip_standard` string
      - `companies` string
      - `naics_standard` string
      - `onet_standard` string
      - `soc_lightcast` string
      - `titles` string
    - `taxonomy_versions` object, required
      - `area` string[]
      - `area_us` string[]
      - `soc` string[]
      - `onet` string[]
      - `title` string[]
      - `titles` string[]
      - `company` string[]
      - `companies` string[]
      - `naics` string[]
      - `naics_standard` string[]
      - `onet_standard` string[]
      - `soc_lightcast` string[]
      - `lot` string[]
    - `distributionFacets` string[], required
    - `pipelineVersion` string, required

## Other responses

- `400`: Your request wasn't valid (bad parameter names or values).

---

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