List Pets

GET

https://api.petstoreapi.com/v1/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

deviceCode

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

Header Params

Responses

🟢200OK

application/json

Successful response with pet collection

Headers

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.petstoreapi.com/v1/pets?species&status&ageMin&ageMax&size&goodWithKids&page&limit' \
--header 'X-Tenant-ID: 550e8400-e29b-41d4-a716-446655440000' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "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-01-07 06:44:25

Create Pet

Upload Pet Image