---
title: "List Schema Subjects"
method: GET
path: "/schema-registry/subjects"
tags: ["Schema Registry"]
---

# List Schema Subjects

`GET /schema-registry/subjects`

List schema subjects for the tenant with pagination.
Excludes internal subjects.
Optional: include_metadata=true to get latest version info in a single request.

## Query parameters

- `page` integer — Page number (1-indexed)
- `page_size` integer — Items per page
- `include_metadata` boolean — Include latest version metadata for each subject
- `search` string, nullable — Search subjects by name (case-insensitive substring match)
- `schema_type` string, nullable — Filter by schema type (AVRO, JSON, PROTOBUF)

## Response `200`

Successful Response

- SchemaSubjectsPaginatedRes — Paginated schema subjects list response.
  - `page` integer, required — Current page number
  - `page_size` integer, required — Items per page
  - `total` integer, required — Total number of subjects
  - `result` union, required — List of schema subjects
    - string[]
    - SchemaSubjectListItem[]
      - `subject` string, required — Schema subject name
      - `schema_type` string, required — Schema type (AVRO, JSON, PROTOBUF)
      - `latest_version` integer, required — Latest schema version
      - `latest_schema_id` integer, required — Latest schema ID

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/streamkap/apis/streamkap-rest-api.md) · [All operations](https://skmtc.net/streamkap/apis/streamkap-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/streamkap/streamkap-rest-api/revisions/8aea6143d003/schema)