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

# Get service metadata

`GET /meta`

## Request

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

Get service metadata, including taxonomies, available years of data (first and last year in which any available profiles were updated), and attribution text.
Caching is encouraged, but the metadata may change weekly.

## Query parameters

- `uksoc_standard_version` '2020.0.0' | '2010.0.0'
- `soc_version` 'uk_soc2010emsi' | 'uk_soc_2020'
- `title_version` 'emsi'
- `company_version` 'emsi_company'
- `lot_version` string
- `newTaxonomyVersions` true | false

## Response `200`

OK

- object
  - `data` object, required
    - `attribution` object, required
      - `title` string, required
      - `body` string, required
    - `taxonomies` object, required
      - `area` string
      - `program` string
      - `soc` string
      - `title` string
      - `company` string
      - `skills` string
      - `area_uk` string
      - `titles` string
      - `companies` string
      - `uksoc_standard` string
      - `lot` string
    - `taxonomy_versions` object
      - `title` string[]
      - `company` string[]
      - `soc` string[]
      - `uksoc_standard` string[]
      - `lot` string[]
    - `facets` string[], required
    - `filters` string[], required
    - `metrics` string[], required
    - `latest_year` string, nullable, required: Latest year any profiles were updated.
    - `earliest_year` string, nullable, required: Earliest year any profiles were updated.
    - `supportsAdvancedFilters` boolean, required
    - `pipelineVersion` string, required

## Other responses

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

---

[API](https://skmtc.dev/lightcast/apis/profiles-uk.md) - [All operations](https://skmtc.dev/lightcast/apis/profiles-uk/llms.txt) - [OpenAPI document](https://skmtc.dev/lightcast/apis/profiles-uk/revisions/562d83d43ab7?raw)