PetstoreAPI Docs
Modern Petstore APIClassic Petstore APIBlog
Modern Petstore APIClassic Petstore APIBlog
  1. Pet
  • Modern Pet Store API: A New Gold Standard for OpenAPI
  • Pet
    • Get Pet
      GET
    • Update Pet
      PUT
    • Delete Pet
      DELETE
    • Create Pet
      POST
    • List Pets
      GET
    • Upload Pet Image
      POST
  • Chat
    • Create Chat Completion
      POST
  • Payments
    • Pay Order
      POST
  • Store
    • List Inventory
      GET
    • Create Order
      POST
    • Get Order
      GET
    • Delete Order
      DELETE
    • Callback Example
      POST
  • User
    • Create User
      POST
    • Update User
      PUT
    • Get User
      GET
    • Delete User
      DELETE
    • Login
      POST
    • Logout
      POST
  • Webhooks
    • Pet Adopted Event
    • New Pet Available Event
  • Schemas
    • Pet
    • PetCollection
    • User
    • OrderPayment
    • Bank Card
    • Bank Account
    • Category
    • Links
    • Order
    • ApiResponse
    • Tag
    • Error
Modern Petstore APIClassic Petstore APIBlog
Modern Petstore APIClassic Petstore APIBlog
  1. Pet

List Pets

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

Request

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
or
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
or
Query Params

Responses

🟢200
application/json
Successful response with pet collection
Headers

Body

🟠400BadRequest
🟠429TooManyRequests
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/pets?species&status&age_min&age_max&size&good_with_kids&page&limit'
Response Response Example
200 - Multiple pets available
{
    "data": [
        {
            "id": "pet_c4t_5x7k9m",
            "species": "CAT",
            "name": "Whiskers",
            "breed": "Domestic Shorthair",
            "ageMonths": 18,
            "size": "MEDIUM",
            "color": "Orange Tabby",
            "gender": "MALE",
            "goodWithKids": true,
            "goodWithPets": true,
            "adoptionFee": 75,
            "description": "Friendly and playful orange tabby looking for a loving home",
            "status": "AVAILABLE",
            "photos": [
                "https://cdn.petstoreapi.com/pets/pet_c4t_5x7k9m/photo1.jpg"
            ],
            "links": {
                "self": "https://api.petstoreapi.com/v1/pets/pet_c4t_5x7k9m",
                "adopt": "https://api.petstoreapi.com/v1/adoptions"
            }
        },
        {
            "id": "pet_d0g_8n2q4w",
            "species": "DOG",
            "name": "Max",
            "breed": "Labrador Retriever",
            "ageMonths": 36,
            "size": "LARGE",
            "color": "Yellow",
            "gender": "MALE",
            "goodWithKids": true,
            "goodWithPets": true,
            "adoptionFee": 150,
            "description": "Energetic and loyal lab who loves fetch and long walks",
            "status": "AVAILABLE",
            "photos": [
                "https://cdn.petstoreapi.com/pets/pet_d0g_8n2q4w/photo1.jpg"
            ],
            "links": {
                "self": "https://api.petstoreapi.com/v1/pets/pet_d0g_8n2q4w",
                "adopt": "https://api.petstoreapi.com/v1/adoptions"
            }
        }
    ],
    "pagination": {
        "page": 1,
        "limit": 20,
        "totalItems": 45,
        "totalPages": 3
    },
    "links": {
        "self": "https://api.petstoreapi.com/v1/pets?page=1&limit=20",
        "next": "https://api.petstoreapi.com/v1/pets?page=2&limit=20",
        "last": "https://api.petstoreapi.com/v1/pets?page=3&limit=20"
    }
}
Modified at 2025-12-17 08:25:04
Previous
Create Pet
Next
Upload Pet Image
Built with