Pets

Find pets by status

List pets whose status is available, pending, or sold.

Returns an array of pets matching one required status value.

Return pets filtered by status.

GET/pet/findByStatus

Authorizationstringheaderrequired

OAuth 2.0 bearer token with `write:pets` and `read:pets` scopes.

statusstringqueryrequired

Status to include. Allowed values are `available`, `pending`, and `sold`; the schema default is `available`.

Response

{200}Successful operation

{400}Invalid status value

$_cURL

curl --request GET \
  --url https://petstore3.swagger.io/api/v3/pet/findByStatus?status=available \
  --header 'Authorization: Bearer example_access_token'

[
  {
    "id": 10,
    "name": "doggie",
    "photoUrls": ["https://example.com/images/doggie.jpg"],
    "status": "available"
  }
]

The contract also defines a default Unexpected error response without a fixed status or body schema.