Retrieve a schema for the subject and version.

GET /subjects/{subject}/versions/{version}

Path parameters

  • subject string Required
  • version string Required

Query parameters

  • deleted boolean
  • format string

    Redpanda version 25.2 or later. For Avro and Protobuf schemas only. Supported values: an empty string '' returns the schema in its current format (default), and serialized (Protobuf only) returns the schema in its Base64-encoded wire binary format. Unsupported values return a 501 error.

Responses

  • 200

    OK

    Hide response attributes Show response attributes object
    • subject string
    • version integer
    • id integer
    • schemaType string
    • references array[object]
      Hide references attributes Show references attributes object
      • name string
      • subject string
      • version integer
    • schema string
    Hide response attributes Show response attributes object
    • subject string
    • version integer
    • id integer
    • schemaType string
    • references array[object]
      Hide references attributes Show references attributes object
      • name string
      • subject string
      • version integer
    • schema string
    Hide response attributes Show response attributes object
    • subject string
    • version integer
    • id integer
    • schemaType string
    • references array[object]
      Hide references attributes Show references attributes object
      • name string
      • subject string
      • version integer
    • schema string
  • 404

    Not Found: Schema not found

    Hide response attributes Show response attributes object
    • error_code integer
    • message string
    Hide response attributes Show response attributes object
    • error_code integer
    • message string
    Hide response attributes Show response attributes object
    • error_code integer
    • message string
  • 422

    Invalid version

    Hide response attributes Show response attributes object
    • error_code integer
    • message string
    Hide response attributes Show response attributes object
    • error_code integer
    • message string
    Hide response attributes Show response attributes object
    • error_code integer
    • message string
  • 500

    Internal Server Error

    Hide response attributes Show response attributes object
    • error_code integer
    • message string
    Hide response attributes Show response attributes object
    • error_code integer
    • message string
    Hide response attributes Show response attributes object
    • error_code integer
    • message string
  • 501

    Not Implemented: The specified format parameter value is not supported

    Hide response attributes Show response attributes object
    • error_code integer
    • message string
    Hide response attributes Show response attributes object
    • error_code integer
    • message string
    Hide response attributes Show response attributes object
    • error_code integer
    • message string
GET /subjects/{subject}/versions/{version} 
curl \
 --request GET 'http://localhost:8081/subjects/{subject}/versions/{version}'
Response examples (200) 
{
  "subject": "string",
  "version": 42,
  "id": 42,
  "schemaType": "string",
  "references": [
    {
      "name": "string",
      "subject": "string",
      "version": 42
    }
  ],
  "schema": "string"
}
Response examples (200) 
{
  "subject": "string",
  "version": 42,
  "id": 42,
  "schemaType": "string",
  "references": [
    {
      "name": "string",
      "subject": "string",
      "version": 42
    }
  ],
  "schema": "string"
}
Response examples (200) 
{
  "subject": "string",
  "version": 42,
  "id": 42,
  "schemaType": "string",
  "references": [
    {
      "name": "string",
      "subject": "string",
      "version": 42
    }
  ],
  "schema": "string"
}
Response examples (404) 
{
  "error_code": 42,
  "message": "string"
}
Response examples (404) 
{
  "error_code": 42,
  "message": "string"
}
Response examples (404) 
{
  "error_code": 42,
  "message": "string"
}
Response examples (422) 
{
  "error_code": 42,
  "message": "string"
}
Response examples (422) 
{
  "error_code": 42,
  "message": "string"
}
Response examples (422) 
{
  "error_code": 42,
  "message": "string"
}
Response examples (500) 
{
  "error_code": 42,
  "message": "string"
}
Response examples (500) 
{
  "error_code": 42,
  "message": "string"
}
Response examples (500) 
{
  "error_code": 42,
  "message": "string"
}
Response examples (501) 
{
  "error_code": 42,
  "message": "string"
}
Response examples (501) 
{
  "error_code": 42,
  "message": "string"
}
Response examples (501) 
{
  "error_code": 42,
  "message": "string"
}