---
title: "Provides a list of version references matching an extension"
method: GET
path: "/api/{namespace}/{extension}/{targetPlatform}/version-references"
tags: ["registry-api"]
---

# Provides a list of version references matching an extension

`GET /api/{namespace}/{extension}/{targetPlatform}/version-references`

## Path parameters

- `namespace` string, required
- `extension` string, required
- `targetPlatform` 'win32-x64' | 'win32-ia32' | 'win32-arm64' | 'linux-x64' | 'linux-arm64' | 'linux-armhf' | 'alpine-x64' | 'alpine-arm64' | 'darwin-x64' | 'darwin-arm64' | 'web' | 'universal', required

## Query parameters

- `size` integer
- `offset` integer

## Response `200`

The extension version references are returned in JSON format

- VersionReferences — List of version references matching an extension
  - `success` string — Indicates success of the operation (omitted if a more specific result type is returned)
  - `warning` string — Indicates a warning; when this is present, other properties can still be used
  - `error` string — Indicates an error; when this is present, all other properties should be ignored
  - `offset` integer, required — Number of skipped entries according to the version references request
  - `totalSize` integer, required — Total number of version references the extension has
  - `versions` VersionReference[], required — Essential metadata of all available versions, limited to the size specified in the version references request
    - `url` string — URL to get the full metadata of this version
    - `files` object — Map of file types (download, manifest, icon, readme, license, changelog) to their respective URLs
    - `version` string
    - `targetPlatform` 'win32-x64' | 'win32-ia32' | 'win32-arm64' | 'linux-x64' | 'linux-arm64' | 'linux-armhf' | 'alpine-x64' | 'alpine-arm64' | 'darwin-x64' | 'darwin-arm64' | 'web' | 'universal' — Name of the target platform
    - `engines` object — Map of engine names to the respective version constraints

## Other responses

- `404` — The specified extension could not be found
- `429` — A client has sent too many requests in a given amount of time

---

[API](https://skmtc.net/livesession/apis/open-vsx-registry-api.md) · [All operations](https://skmtc.net/livesession/apis/open-vsx-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/livesession/open-vsx-registry-api/versions/badd706d3136/schema)