List Pets

GET

/pets

Retrieve a paginated list of pets available for adoption with optional filtering.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

OAuth 2.0

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://auth.petstoreapi.com/authorize

Token URL: https://auth.petstoreapi.com/token

Refresh URL: https://auth.petstoreapi.com/refresh

Query Params

Responses

🟢200OK

application/json

Successful response with pet collection

Headers

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠429TooManyRequests

🔴500InternalServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/pets?species=undefined&status=undefined&ageMin=undefined&ageMax=undefined&size=undefined&goodWithKids=undefined&page=undefined&limit=undefined' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Multiple pets available

{
    "data": [
        {
            "id": "01936c8f-1234-7000-8000-111111111111",
            "species": "CAT",
            "name": "Whiskers",
            "breed": "Domestic Shorthair",
            "ageMonths": 18,
            "size": "MEDIUM",
            "color": "Orange Tabby",
            "gender": "MALE",
            "goodWithKids": true,
            "price": "75.00",
            "description": "Friendly and playful orange tabby looking for a loving home",
            "status": "AVAILABLE",
            "photos": [
                "https://cdn.petstoreapi.com/pets/01936c8f-1234-7000-8000-111111111111/photo1.jpg"
            ]
        },
        {
            "id": "01936c8f-2345-7000-8000-222222222222",
            "species": "DOG",
            "name": "Max",
            "breed": "Labrador Retriever",
            "ageMonths": 36,
            "size": "LARGE",
            "color": "Yellow",
            "gender": "MALE",
            "goodWithKids": true,
            "price": "150.00",
            "description": "Energetic and loyal lab who loves fetch and long walks",
            "status": "AVAILABLE",
            "photos": [
                "https://cdn.petstoreapi.com/pets/01936c8f-2345-7000-8000-222222222222/photo1.jpg"
            ]
        }
    ],
    "pagination": {
        "page": 1,
        "limit": 20,
        "totalItems": 45,
        "totalPages": 3
    }
}

Modified at 2026-05-13 03:16:01

Pet

Create Pet