---
title: "List cat breeds"
url: "https://sg-dev-1.scripture.sh/apis/animal-facts-api-1/versions/cb120a4d-754c-446d-bfae-b856ae097070/operations/listCatBreeds"
---

> Full API specification: https://sg-dev-1.scripture.sh/apis/animal-facts-api-1/versions/cb120a4d-754c-446d-bfae-b856ae097070.md

# List cat breeds

`GET` `/cats/breeds`

Operation ID: `listCatBreeds`

Returns a list of cat breeds with pagination.

## Query parameters

- `limit` (integer, int32, optional) - Maximum number of items to return
- `offset` (integer, int32, optional) - Number of items to skip for pagination

## Responses

- `200` - Successful operation

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Animal Facts API
  version: 1.0.0
servers:
  - url: https://api.example.com
    description: Production server
paths:
  /cats/breeds:
    get:
      summary: List cat breeds
      description: Returns a list of cat breeds with pagination.
      operationId: listCatBreeds
      tags:
        - Cats
      parameters:
        - name: limit
          in: query
          description: Maximum number of items to return
          schema:
            type: integer
            format: int32
            minimum: 1
            maximum: 100
            default: 20
        - name: offset
          in: query
          description: Number of items to skip for pagination
          schema:
            type: integer
            format: int32
            minimum: 0
            default: 0
      responses:
        "200":
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: "#/components/schemas/Breed"
                  meta:
                    type: object
                    properties:
                      page:
                        type: object
                        properties:
                          offset:
                            type: integer
                            description: The offset used for pagination.
                          limit:
                            type: integer
                            description: The limit used for pagination.
                          total:
                            type: integer
                            description: The total number of items available.
                          estimated_total:
                            type: boolean
                            description: Indicates if the total is an estimate.
components:
  schemas:
    Breed:
      type: object
      properties:
        name:
          type: string
          description: The name of the breed.
          example: Siamese
        origin:
          type: string
          description: The origin of the breed.
          example: Thailand
```