---
title: "Gets layer versions for catalog version"
method: GET
path: "/layerVersions"
tags: ["metadata"]
---

# Gets layer versions for catalog version

`GET /layerVersions`

Returns information about layer versions for the catalog version. It will return an error if the catalog does not have any versions or if the version passed in the query parameter does not exist. If a layer does not have any data for the requested version it is excluded from the response.

## Query parameters

- `version` integer, required
- `billingTag` string

## Response `200`

OK

- LayerVersions — Describes the list of the layer versions for a given catalog version.
  - `layerVersions` LayerVersion[], required — List of layer versions
    - `layer` string, required — Layer ID
    - `version` integer, required — Version of the layer when it was last updated
    - `timestamp` integer, required — Each time a layer version increments, this updates `timestamp` for this layer version *and* `timestamp` for the related catalog version, which increments as well. The `timestamp` is in milliseconds since UNIX Epoch time.
  - `version` integer, required — Catalog version

## Other responses

- `400` — Required parameters are missing
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Catalog does not exist

---

[API](https://skmtc.dev/here/apis/query-api-v1.md) · [All operations](https://skmtc.dev/here/apis/query-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/here/query-api-v1/revisions/30e5d2645407/schema)