---
title: "Gets catalog versions"
method: GET
path: "/versions"
tags: ["metadata"]
---

# Gets catalog versions

`GET /versions`

Returns information about specific catalog version(s). If the catalog doesn't contain any versions 404 will be returned. Maximum number of versions to be returned per call is 1000 versions. If requested range is bigger than 1000 versions 400 Bad Request will be returned.
Expected either pair 'startVersion' and 'endVersion', or 'version' query parameter, otherwise 400 Bad Request will be returned.

## Query parameters

- `startVersion` integer
- `endVersion` integer
- `version` integer[]
- `billingTag` string
- `context` 'default' | 'extension' | 'super'

## Response `200`

OK

- VersionInfos — Describes the list of version information for a catalog.
  - `versions` VersionInfo[], required
    - `dependencies` VersionDependency[], required — A list of the catalog dependencies.
      - `direct` boolean, required — Indicates the type of data dependency. If this value is set to false, this dependency is an indirect dependency. This means that data from this catalog was not directly used by a data processing pipeline to update the current version of the catalog. Instead, the data was only used by upstream pipeline(s) to generate the input data.
      - `hrn` string, required — The HERE Resource Name (HRN) of the catalog that the batch commit depends on.
      - `version` integer, required — The version of the catalog metadata that the batch commit depends on.
    - `partitionCounts` object — A map of the layers in the catalog and their partition counts. The map is expressed in key value pairs.
    - `timestamp` integer, required — A `timestamp` that indicates when the version was created. The `timestamp` is in milliseconds since UNIX Epoch time.
    - `version` integer, required — The version of the catalog metadata. It is incremented every time a catalog metadata is changed e.g. by publishing new partitions to durable layers.

## Other responses

- `400` — Bad Request - indicates that request failed fast validation e.g. syntax, some logical errors or required parameters are missing
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Catalog does not exist or the catalog doesn't contain any versions
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[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)