Retrieve a pet by ID

1 parameter

petIdintegerrequired

The unique identifier of the pet to retrieve.

4 status codes

200Returns the pet object with its identifier, name, category, photo URLs, tags, and status.

idintegeroptional

namestringrequired

categoryobjectoptional

photoUrlsarray<string>required

tagsarray<object>optional

statusstringoptional

pet status in the store

Allowed:availablependingsold

400Returned when `petId` is not a valid integer.

404Returned when no pet exists with the given `petId`.

defaultUnexpected error

Error handling

A 404 is returned if no pet exists with the given petId. petId must be a valid integer — non-numeric values return a 400.

import { Client } from "acme-sdk";

const client = new Client({
  baseUrl: "https://api.acme.com",
});

const result = await client.pet.get({ petId: "9b2f1c10-7a3e-4d54-8c2a-1f6b9e0d4a21" });

{
  "id": 10,
  "name": "doggie",
  "category": {
    "id": 1,
    "name": "Dogs"
  },
  "photoUrls": [
    "https://example.com"
  ],
  "tags": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Jane Doe"
    }
  ],
  "status": "available"
}

Request

Response

Errors