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

# Get service metadata

`GET /meta`

## Request

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

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

- `new_taxonomy_versions` true | false
- `lot_version` '6' | '7'
- `area_version` 'lf_area_2023_2' | 'lf_area_2025_1'
- `area_laa_version` '1' | '2'

## Response `200`

OK

- object
  - `data` object, required
    - `available_months` string[], required
    - `nation_start_month` object
    - `attribution` object, required
      - `title` string, required
      - `body` string, required
    - `facets` string[]
    - `filters` string[]
    - `postingFields` string[], required
    - `latest_day` string, required
    - `metrics` string[]
    - `supportsAdvancedFilters` boolean, required
    - `taxonomy_versions` object
      - `lot` string[]
      - `area` string[]
      - `area_laa` string[]
      - `naics` string[]
      - `naics_standard` string[]
    - `taxonomies` object, required
      - `area` string
      - `area_global` string
      - `occupation_global` string
      - `title` string
      - `skills` string
      - `company` string
      - `isco` string
      - `lot` string
      - `nace` string
      - `area_laa` string
      - `titles` string
      - `companies` string
      - `isco_standard` string
      - `naics` string
      - `naics_standard` string
    - `distributionFacets` string[], required
    - `pipelineVersion` string, required

## Other responses

- `400`: bad request
- `401`: unauthorized request

---

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