---
title: "Get a list of versions registered under the subject."
method: GET
path: "/subjects/{subject}/versions"
tags: ["Subjects"]
---

# Get a list of versions registered under the subject.

`GET /subjects/{subject}/versions`

## Request

- The document declares no server URL.
- Auth: none declared

## Path parameters

- `subject` string, required

## Query parameters

- `deleted` boolean
- `deletedOnly` boolean
- `offset` integer
- `limit` integer

## Headers

- `X-Registry-GroupId` string

## Response `200`

List of version numbers registered under the subject.

- integer[]

## Other responses

- `404`: Error returned by the Schema Registry API
- `500`: Error returned by the Schema Registry API

---

[API](https://skmtc.dev/apicurio/apis/apicurio-registry-confluent-compatibility-api.md) - [All operations](https://skmtc.dev/apicurio/apis/apicurio-registry-confluent-compatibility-api/llms.txt) - [OpenAPI document](https://skmtc.dev/apicurio/apis/apicurio-registry-confluent-compatibility-api/revisions/a2f9ca447c9b?raw)