API Academy
🌐 English
  • 🌐 English
  • 🌐 繁體中文
HomePetstore APIExplore more APIs
HomePetstore APIExplore more APIs
🌐 English
  • 🌐 English
  • 🌐 繁體中文
🌐 English
  • 🌐 English
  • 🌐 繁體中文
  1. Pet
  • Introduction
  • Table of Contents
  • API Academy
    • Get Started
      • What is an API?
      • How Does an API Work?
      • How to Call an API?
      • How to Read an API Documentation?
      • Chapter Summary
      • Get realtime weather
    • API Fundamentals
      • API Funtamentals: Overview
      • Method & Path
      • Parameters
      • Request Body
      • Responses
      • API Specification & OAS
      • Chapter Summary
    • Working with APIs
      • Working with APIs: Overview
      • Making Requests from Spec
      • Environments and Variables
      • Chaining Multiple Endpoints
      • Handling Authentication
      • Handling API Signatures
      • Introduction to Scripts
      • Chapter Summary
    • Mocking APIs
      • Mocking APIs: Overview
      • Smart Mock
      • Mock Expectations
      • Cloud Mock
      • Mock Scripts
      • Chapter Summary
    • Designing APIs
      • Designing APIs: Overview
      • Introduction to API Design
      • Creating Your First API Project
      • Analyzing Requirements and Planning Your API
      • Designing Data Models
      • Designing Endpoints
      • Using Components and Reusability
      • Setting Up Authentication
      • API Design Guidelines
      • Chapter Summary
    • Developing APIs
      • Developing APIs: Overview
      • Setup: Install Your AI Coding Assistant
      • Quick Start: From Spec to Running API in 30 Minutes
      • Understanding the Generated Code
      • Testing Your API with Apidog
      • Deployment: Put Your API Online
      • Chapter Summary
    • Testing APIs
      • Testing APIs: Overview
      • Getting Started: Your First Test Scenario
      • Integration Testing and Data Passing
      • Dynamic Values
      • Assertions and Validations
      • Flow Control: If, For, ForEach
      • Data-Driven Testing
      • Performance Testing
      • Test Reports and Analysis
      • CI/CD Integration
      • Scheduled Tasks and Automation
      • Advanced Testing Strategies
      • Chapter Summary
    • API Documentations
      • API Documentations: Overview
      • Publishing Your First API Doc
      • Customizing Documentation Appearance
      • Interactive Features for Consumers
      • Advanced Publishing Settings
      • Managing API Versions
      • Chapter Summary
    • Advanced API Technologies
      • API Technologies: Overview
      • GraphQL
      • gRPC
      • WebSocket
      • Socket.IO
      • Server-Sent Events (SSE)
      • SOAP
      • Chapter Summary
    • API Lifecycle
      • API Lifecycle: Overview
      • Stages of the API Lifecycle
      • API Governance
      • API Security Best Practices
      • Monitoring and Analytics
      • API Versioning Strategies
      • The Future of APIs
      • Chapter Summary
    • API Security
      • API Security: Overview
      • API Security Fundamentals
      • Authentication vs Authorization
      • Understanding OAuth 2.0 and OpenID Connect
      • JSON Web Tokens (JWT)
      • OWASP API Security Top 10
      • Encryption and HTTPS
      • Chapter Summary
    • API Tools
      • API Tools: Overview
      • The Evolution of API Tools
      • API Clients
      • Command Line Tools (cURL, HTTPie)
      • API Design and Documentation Tools
      • API Mocking Tools
      • API Testing Tools
      • All-in-One API Platforms
      • Chapter Summary
    • API Gateway
      • API Gateway: Overview
      • What is an API Gateway?
      • Key Features of API Gateways
      • API Gateway vs Load Balancer vs Service Mesh
      • Popular API Gateway Solutions
      • The BFF (Backend for Frontend) Pattern
      • Chapter Summary
  • Modern Pet Store
    • Pet
      • Get Pet
        GET
      • Update Pet
        PUT
      • Delete Pet
        DELETE
      • Create Pet
        POST
      • List Pets
        GET
      • Upload Pet Image
        POST
    • User
      • Update User
      • Get User
      • Delete User
      • Login
      • Logout
      • Create User
    • Store
      • List Inventory
      • Create Order
      • Get Order
      • Delete Order
      • Callback Example
      • Pay for an Order
    • Payments
      • Pay Order
    • Chat
      • Create Chat Completion
    • Webhooks
      • Pet Adopted Event
      • New Pet Available Event
  • Schemas
    • Pet
    • Category
    • User
    • ApiResponse
    • OrderPayment
    • Tag
    • Order
    • Links-Order
    • PetCollection
    • Bank Card
    • Bank Account
    • Links
    • Error
HomePetstore APIExplore more APIs
HomePetstore APIExplore more APIs
🌐 English
  • 🌐 English
  • 🌐 繁體中文
🌐 English
  • 🌐 English
  • 🌐 繁體中文
  1. Pet

List Pets

Production server
https://api.petstoreapi.com/v1
Production server
https://api.petstoreapi.com/v1
GET
/pets
Retrieve a paginated list of pets available for adoption with optional filtering.

Request

Authorization
Query Params

Responses

🟒200OK
application/json
Successful response with pet collection
Headers

Body

🟠400Bad Request
🟠429Unauthorized
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.petstoreapi.com/v1/pets?species&status&age_min&age_max&size&good_with_kids&page&limit'
Response Response Example
200 - Multiple pets available
{
    "data": [
        {
            "id": "pet_1Nv0FGQ9RKHgCVdK",
            "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_1Nv0FGQ9RKHgCVdK/photo1.jpg"
            ],
            "links": {
                "self": "https://api.petstoreapi.com/v1/pets/pet_1Nv0FGQ9RKHgCVdK",
                "adopt": "https://api.petstoreapi.com/v1/adoptions"
            }
        },
        {
            "id": "pet_2Mx1EHR8SLIfDWeL",
            "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_2Mx1EHR8SLIfDWeL/photo1.jpg"
            ],
            "links": {
                "self": "https://api.petstoreapi.com/v1/pets/pet_2Mx1EHR8SLIfDWeL",
                "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-19 04:10:36
Previous
Create Pet
Next
Upload Pet Image
Built with