Get a pet by ID | Swagger Petstore

1 parameter

petIdintegerrequired

The numeric identifier of the pet to retrieve.

4 status codes

200Returns the pet object identified by petId, including its name, category, photo URLs, tags, and store status.

idintegeroptional

namestringrequired

categoryobjectoptional

photoUrlsarray<string>required

tagsarray<object>optional

statusstringoptional

pet status in the store

Allowed:availablependingsold

400Returned when petId is invalid.

404Returned when no pet exists with the supplied petId.

defaultReturned when an unexpected error occurs.

Error handling

A 400 is returned when petId is not a valid numeric identifier. A 404 is returned when no pet exists with the supplied petId.

import { SwaggerPetstoreOpenAPI30 } from "swagger-petstore---openapi-3-0-sdk";

const client = new SwaggerPetstoreOpenAPI30({
  baseUrl: "/api/v3",
  auth: { apiKey: process.env.SWAGGER_PETSTORE_API_KEY! },
});

const result = await client.pet.getById({ petId: 7082 });

{
  "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