Skip to main content
GET
/
pets
/
{id}
TypeScript SDK
import { PetStoreAPI } from '@petstoreapi/sdk';

const client = new PetStoreAPI({
  apiKey: process.env.PETSTORE_API_KEY
});

const pet = await client.pets.get('01936c8f-1234-7000-8000-111111111111');
console.log(`Found ${pet.name}, a ${pet.age_months}-month-old ${pet.species}`);
{
  "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",
    "https://cdn.petstoreapi.com/pets/01936c8f-1234-7000-8000-111111111111/photo2.jpg"
  ],
  "medicalInfo": {
    "spayedNeutered": true,
    "vaccinated": true,
    "microchipped": true,
    "specialNeeds": false
  }
}

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.

Path Parameters

id
string<uuid>
required

Unique identifier for the pet

Response

Successful response with pet details

Animal information in the pet store available for adoption.

id
string<uuid>
required

Unique identifier for the pet (UUID v7)

Examples:

"019b4132-70aa-764f-b315-e2803d882a24"

"019b4127-54d5-76d9-b626-0d4c7bfce5b6"

species
enum<string>
required

The species of the pet

Available options:
DOG,
CAT,
RABBIT,
BIRD,
REPTILE,
OTHER
name
string
required

The pet's name

Required string length: 1 - 50
Examples:

"Whiskers"

"Max"

"Luna"

ageMonths
integer
required

Age of the pet in months

Required range: x >= 0
Examples:

18

36

6

price
string
required

Adoption fee amount

Examples:

"75.00"

"150.00"

"50.00"

currency
string
default:USD
required

Currency code for the adoption fee (ISO 4217)

Examples:

"USD"

"EUR"

"GBP"

status
enum<string>
required

Current adoption status

Available options:
AVAILABLE,
PENDING,
ADOPTED,
NOT_AVAILABLE
createdAt
string<date-time>
required

Timestamp when the pet record was created (RFC 3339)

Examples:

"2025-12-21T13:56:23Z"

"2025-11-15T08:30:00Z"

updatedAt
string<date-time>
required

Timestamp when the pet record was last updated (RFC 3339)

Examples:

"2025-12-21T13:56:23Z"

"2025-12-21T15:30:45Z"

breed
string

The breed of the pet

Examples:

"Domestic Shorthair"

"Labrador Retriever"

"Holland Lop"

size
enum<string>

Size category of the pet

Available options:
SMALL,
MEDIUM,
LARGE
color
string

Primary color or coloring pattern

Examples:

"Orange Tabby"

"Black"

"Brown and White"

gender
enum<string>

The pet's gender

Available options:
MALE,
FEMALE,
UNKNOWN
goodWithKids
boolean

Whether the pet is good with children

description
string

Detailed description of the pet's personality and traits

tenantId
string<uuid> | null

Optional tenant identifier for data isolation. When present, indicates this pet belongs to a specific tenant. Null or omitted means the pet is in the shared/public data pool.

Examples:

"550e8400-e29b-41d4-a716-446655440000"

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

photos
string<uri>[]

URLs of pet photos

medicalInfo
object