---
title: "Gets a list of available catalog versions that respect the given dependencies"
method: POST
path: "/versions/compatibles"
tags: ["metadata"]
---

# Gets a list of available catalog versions that respect the given dependencies

`POST /versions/compatibles`

Given a list of HRNs and versions provided by the user, returns a list of versions of this catalog for which the listed HRN are either present in the direct or indirect dependencies with the same version, or are not present. Depending on 'strict' flag versions that don't depend on any of the provided catalog HRNs, can also be considered compatible. The compatible versions are returned in reverse order, from the newest to the oldest. When there is no compatible version the service returns an empty list. When the catalog has no version a 404 is returned.

## Query parameters

- `limit` integer
- `strict` boolean

## Request body

- Dependencies
  - `dependencies` CatalogVersion[] — A list of catalog versions.
    - `hrn` string, required — The HERE Resource Name (HRN) of a catalog.
    - `version` integer, required — The version of the catalog metadata.

## Response `200`

OK

- VersionsResponse
  - `versions` object[] — A list of catalog versions.
    - `version` integer
    - `sharedDependencies` CatalogVersion[] — A list of the catalog.
      - `hrn` string, required — The HERE Resource Name (HRN) of a catalog.
      - `version` integer, required — The version of the catalog metadata.
  - `next` string, uri — If the number of results exceeds the provided limit then this uri will be present and will provide the path to the next batch of results.

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