Finds Pets by tags

GET 
https://petstore.swagger.io/v2/pet/findByTags

deprecated

This endpoint has been deprecated and may be replaced or removed in future versions of the API.

Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.

Request

Query Parameters

tags string[]required

Tags to filter by

Responses

200

successful operation

application/json

Schema

Schema

Array [
idint64
Pet ID
category Category
Categories this pet belongs to
idint64
Category ID
namestring
Category name
Possible values: non-empty
sub object
Test Sub Category
prop1string
Dumb Property
namestringrequired
The name given to a pet
Example: Guru
photoUrlsurl[]required
The list of URL to a cute photos featuring pet
Possible values: <= 20
friendcircular(Pet)
tags Tag[]
Tags attached to the pet
Possible values: >= 1
Array [
idint64
Tag ID
namestring
Tag name
Possible values: non-empty
]
statusstring
Pet status in the store
Possible values: [available, pending, sold]
petType object
Type of a pet
Possible values: [cat, dog, bee]
cat
huntingSkillstringrequired
The measured skill for hunting
Possible values: [clueless, lazy, adventurous, aggressive]
Default value: lazy
Example: adventurous
dog
packSizeint32required
The size of the pack the dog is from
Possible values: >= 1
Default value: 1
bee
honeyPerDaynumberrequired
Average amount of honey produced per day in ounces
Example: 3.14
]

Example (auto)

[
  {
    "id": 0,
    "category": {
      "id": 0,
      "name": "string",
      "sub": {
        "prop1": "string"
      }
    },
    "name": "Guru",
    "photoUrls": [
      "string"
    ],
    "friend": {},
    "tags": [
      {
        "id": 0,
        "name": "string"
      }
    ],
    "status": "available",
    "petType": {
      "huntingSkill": "adventurous"
    }
  }
]

application/xml

Schema

Schema

Array [
idint64
Pet ID
category Category
Categories this pet belongs to
idint64
Category ID
namestring
Category name
Possible values: non-empty
sub object
Test Sub Category
prop1string
Dumb Property
namestringrequired
The name given to a pet
Example: Guru
photoUrlsurl[]required
The list of URL to a cute photos featuring pet
Possible values: <= 20
friendcircular(Pet)
tags Tag[]
Tags attached to the pet
Possible values: >= 1
Array [
idint64
Tag ID
namestring
Tag name
Possible values: non-empty
]
statusstring
Pet status in the store
Possible values: [available, pending, sold]
petType object
Type of a pet
Possible values: [cat, dog, bee]
cat
huntingSkillstringrequired
The measured skill for hunting
Possible values: [clueless, lazy, adventurous, aggressive]
Default value: lazy
Example: adventurous
dog
packSizeint32required
The size of the pack the dog is from
Possible values: >= 1
Default value: 1
bee
honeyPerDaynumberrequired
Average amount of honey produced per day in ounces
Example: 3.14
]

Example (auto)

<0>
  <id>0</id>
  <category>
    <id>0</id>
    <name>string</name>
    <sub>
      <prop1>string</prop1>
    </sub>
  </category>
  <name>Guru</name>
  <photoUrls>string</photoUrls>
  <friend/>
  <tags>
    <id>0</id>
    <name>string</name>
  </tags>
  <status>available</status>
  <petType>
    <huntingSkill>adventurous</huntingSkill>
  </petType>
</0>

400

Invalid tag value

Authorization: oauth2

name: petstore_authtype: oauth2scopes: write:pets,read:petsdescription: Get access to data while protecting your account credentials.
OAuth2 is also a safer and more secure way to give you access.
flows: {
  "implicit": {
    "authorizationUrl": "http://petstore.swagger.io/api/oauth/dialog",
    "scopes": {
      "write:pets": "modify pets in your account",
      "read:pets": "read your pets"
    }
  }
}

• python
• curl
• csharp
• go
• nodejs
• ruby
• php
• java
• powershell
• dart
• javascript
• c
• objective-c
• ocaml
• r
• swift
• kotlin
• rust

• HTTP.CLIENT
• REQUESTS

import http.client

conn = http.client.HTTPSConnection("petstore.swagger.io")
payload = ''
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer <token>'
}
conn.request("GET", "/v2/pet/findByTags", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Request Collapse all

Base URL

https://petstore.swagger.io/v2

Auth

Bearer Token

Parameters

tags — queryrequired

ResponseClear

Click the Send API Request button above and see the response here!