Guides
Find pets
Retrieve pets by status, tag, or identifier.
Choose the lookup operation that matches the information you have. All pet searches require OAuth 2.0 in the published contract; the ID lookup alternatively accepts an API key.
1
Choose a lookup
- Use Find pets by status for
available,pending, orsoldpets. - Use Find pets by tags when you have one or more tag strings.
- Use Get a pet when you have a numeric pet ID.
2
Add a credential
Send an OAuth 2.0 bearer token with both published pet scopes. For an ID lookup, you can instead send the api_key header.
3
Interpret the result
A successful status or tag search returns an array of Pet objects. A successful ID lookup returns one Pet object. A 404 is defined only for the ID lookup and means that the pet was not found.
Use
available as the initial status value; it is the contract default and one of the three allowed values.Next, review the Pet data model or manage a pet.