GET /schemas/ids/{id}

Path parameters

  • id integer Required

Query parameters

  • 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.

  • subject string

    Qualified subject to scope the lookup. Use :.: for context-only lookup, or :.: to also verify the schema is associated with that subject. Defaults to searching the default context if unspecified.

  • referenceFormat string

    If set to 'qualified', schema references are returned in context-qualified form. Otherwise, unqualified references are returned.

Responses

  • 200

    OK

    Hide response attributes Show response attributes object
    • schema string
    • schemaType string
    • references array[object]
      Hide references attributes Show references attributes object
      • name string

        The name used to reference this schema in the dependent schema definition.

      • subject string

        The subject name of the referenced schema. Use [:.:] for context-qualified subjects, or just for the default context.

      • version integer

        The version of the referenced schema.

    • metadata object
      Hide metadata attribute Show metadata attribute object
      • properties object
        Hide properties attribute Show properties attribute object
        • * string Additional properties
    Hide response attributes Show response attributes object
    • schema string
    • schemaType string
    • references array[object]
      Hide references attributes Show references attributes object
      • name string

        The name used to reference this schema in the dependent schema definition.

      • subject string

        The subject name of the referenced schema. Use [:.:] for context-qualified subjects, or just for the default context.

      • version integer

        The version of the referenced schema.

    • metadata object
      Hide metadata attribute Show metadata attribute object
      • properties object
        Hide properties attribute Show properties attribute object
        • * string Additional properties
    Hide response attributes Show response attributes object
    • schema string
    • schemaType string
    • references array[object]
      Hide references attributes Show references attributes object
      • name string

        The name used to reference this schema in the dependent schema definition.

      • subject string

        The subject name of the referenced schema. Use [:.:] for context-qualified subjects, or just for the default context.

      • version integer

        The version of the referenced schema.

    • metadata object
      Hide metadata attribute Show metadata attribute object
      • properties object
        Hide properties attribute Show properties attribute object
        • * string Additional properties
  • 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
  • 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 /schemas/ids/{id} 
curl \
 --request GET 'http://localhost:8081/schemas/ids/{id}'
Response examples (200) 
{
  "schema": "string",
  "schemaType": "string",
  "references": [
    {
      "name": "string",
      "subject": "string",
      "version": 42
    }
  ],
  "metadata": {
    "properties": {
      "additionalProperty1": "string",
      "additionalProperty2": "string"
    }
  }
}
Response examples (200) 
{
  "schema": "string",
  "schemaType": "string",
  "references": [
    {
      "name": "string",
      "subject": "string",
      "version": 42
    }
  ],
  "metadata": {
    "properties": {
      "additionalProperty1": "string",
      "additionalProperty2": "string"
    }
  }
}
Response examples (200) 
{
  "schema": "string",
  "schemaType": "string",
  "references": [
    {
      "name": "string",
      "subject": "string",
      "version": 42
    }
  ],
  "metadata": {
    "properties": {
      "additionalProperty1": "string",
      "additionalProperty2": "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 (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"
}