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

# Get service metadata

`GET /meta`

## Request

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

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` 'uk_soc_2020'
- `title_version` 'emsi'
- `company_version` 'emsi_company'
- `lot_version` '6' | '7'
- `area_version` 'uk_area_2015'
- `new_taxonomy_versions` true | false

## 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
      - `skills` string, required
      - `title` string
      - `soc` string
      - `company` string
      - `lot` string, required
      - `ttwa` string, required
      - `sic` string
      - `area_uk` string
      - `companies` string
      - `titles` string
      - `uksic_standard` string
      - `uksoc_standard` string
    - `taxonomy_versions` object, required
      - `title` string[]
      - `soc` string[]
      - `area` string[]
      - `company` string[]
      - `lot` string[]
    - `distributionFacets` string[], required
    - `pipelineVersion` string, required

## Other responses

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

---

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