> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moca.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Browse schemas

> Returns a paginated list of credential schemas with their credential count and number of distinct issuers (providers). Only schemas marked as discoverable and enabled are included. Results are sortable by `created_at`, `credential_count`, `provider_count`, or `title` (default `created_at`).



## OpenAPI

````yaml GET /catalog/schemas
openapi: 3.0.3
info:
  title: Moca Network API
  description: >-
    Server-to-server API for credential issuance, status tracking, catalog
    browsing, and partner operations on the Moca Network.
  version: 1.0.0
  contact:
    name: Moca Network
    url: https://moca.network
servers:
  - url: https://api.sandbox.mocachain.org/v1
    description: Sandbox
  - url: https://mocachain-mainnet.api.air3.com/v1
    description: Production
security:
  - partnerJwt: []
paths:
  /catalog/schemas:
    get:
      tags:
        - Catalog
      summary: Browse schemas
      description: >-
        Returns a paginated list of credential schemas with their credential
        count and number of distinct issuers (providers). Only schemas marked as
        discoverable and enabled are included. Results are sortable by
        `created_at`, `credential_count`, `provider_count`, or `title` (default
        `created_at`).
      operationId: listSchemas
      parameters:
        - $ref: '#/components/parameters/Page'
        - $ref: '#/components/parameters/Limit'
        - $ref: '#/components/parameters/SortBy'
        - $ref: '#/components/parameters/SortOrder'
      responses:
        '200':
          description: Paginated list of schemas.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogApiResponse'
              example:
                code: 80000000
                msg: success
                data:
                  current: 1
                  pages: 5
                  size: 10
                  total: 47
                  records:
                    - schemaId: sch_01HX
                      title: KYC Identity
                      description: Basic identity verification schema
                      credentialCount: 5
                      providerCount: 3
                timestamp: 1772530828000
      security: []
      servers:
        - url: https://credential-testnet.api.sandbox.air3.com
          description: Credential API sandbox (catalog)
components:
  parameters:
    Page:
      name: page
      in: query
      required: false
      description: Page number (starts from 1).
      schema:
        type: integer
        minimum: 1
        default: 1
    Limit:
      name: limit
      in: query
      required: false
      description: Results per page (max 100).
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 10
    SortBy:
      name: sortBy
      in: query
      required: false
      description: Field to sort by.
      schema:
        type: string
    SortOrder:
      name: sortOrder
      in: query
      required: false
      description: Sort direction.
      schema:
        type: string
        enum:
          - ASC
          - DESC
        default: DESC
  schemas:
    CatalogApiResponse:
      type: object
      description: Standard API response envelope used by all Catalog endpoints.
      properties:
        code:
          type: integer
          description: Response code. `80000000` indicates success.
          example: 80000000
        msg:
          type: string
          description: Human-readable status message.
          example: success
        data:
          description: Response payload. Shape varies per endpoint.
        timestamp:
          type: integer
          description: UNIX timestamp in milliseconds.
          example: 1772530828000
  securitySchemes:
    partnerJwt:
      type: apiKey
      in: header
      name: x-partner-auth
      description: >-
        A signed Partner JWT containing `partnerId`, `email`, `scope`, and `exp`
        claims. See [Partner
        Authentication](/airkit/usage/partner-authentication) for setup.

````