Skip to main content
GET
/
pets
List Pets
curl --request GET \
  --url https://api.petstoreapi.com/v1/pets
{
  "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
  }
}

Headers

​
X-Tenant-ID
string<uuid>

Optional tenant identifier for data isolation. When provided, all operations will be scoped to this tenant, ensuring data separation between different organizations or users. If omitted, operations will access the shared/public data pool where data may be visible to and modified by other users.

Query Parameters

​
species
enum<string>

Filter by pet species

Available options:
DOG,
CAT,
RABBIT,
BIRD,
REPTILE,
OTHER
​
status
enum<string>
default:AVAILABLE

Filter by adoption status

Available options:
AVAILABLE,
PENDING,
ADOPTED
​
ageMin
integer

Minimum age in months

Required range: x >= 0
​
ageMax
integer

Maximum age in months

Required range: x >= 0
​
size
enum<string>

Filter by pet size

Available options:
SMALL,
MEDIUM,
LARGE
​
goodWithKids
boolean

Filter pets that are good with children

​
page
integer
default:1

Page number for pagination

Required range: x >= 1
​
limit
integer
default:20

Number of items per page

Required range: 1 <= x <= 100

Response

Successful response with pet collection

Collection of pets with pagination

​
data
object[]
required
​
pagination
object
required