Skip to content

Swagger Petstore - OpenAPI 3.0 (1.0.20-SNAPSHOT)

This is a sample Pet Store Server based on the OpenAPI 3.0 specification. You can find out more about Swagger at http://swagger.io. In the third iteration of a pet store, we've switched to the design first approach! You can now help us improve the API whether it's by making changes to the definition itself or to the code. That way, with time, we can improve the API in general, and expose some of the new features in OAS3.

Some useful links:

Download OpenAPI description
Languages
Servers
Mock server

https://innovario.apishowdown.com/_mock/catalog/api-showdown/api-hub/pet-store/openapi/

https://innovario.apishowdown.com/v3/

Operations
Operations

Request

Returns a map of status codes to quantities

Security
api_key
curl -i -X GET \
  https://innovario.apishowdown.com/_mock/catalog/api-showdown/api-hub/pet-store/openapi/store/inventory \
  -H 'api_key: YOUR_API_KEY_HERE'

Responses

successful operation

Bodyapplication/json
property name*integer(int32)additional property
Response
application/json
{ "property1": 0, "property2": 0 }

Request

Place a new order in the store

Body
idinteger(int64)
Example: 10
petIdinteger(int64)
Example: 198772
quantityinteger(int32)
Example: 7
shipDatestring(date-time)
statusstring

Order Status

Enum"placed""approved""delivered"
Example: "approved"
completeboolean
curl -i -X POST \
  https://innovario.apishowdown.com/_mock/catalog/api-showdown/api-hub/pet-store/openapi/store/order \
  -H 'Content-Type: application/json' \
  -d '{
    "id": 10,
    "petId": 198772,
    "quantity": 7,
    "shipDate": "2019-08-24T14:15:22Z",
    "status": "approved",
    "complete": true
  }'

Responses

successful operation

Bodyapplication/json
idinteger(int64)
Example: 10
petIdinteger(int64)
Example: 198772
quantityinteger(int32)
Example: 7
shipDatestring(date-time)
statusstring

Order Status

Enum"placed""approved""delivered"
Example: "approved"
completeboolean
Response
application/json
{ "id": 10, "petId": 198772, "quantity": 7, "shipDate": "2019-08-24T14:15:22Z", "status": "approved", "complete": true }

Request

For valid response try integer IDs with value <= 5 or > 10. Other values will generate exceptions.

Path
orderIdinteger(int64)required

ID of order that needs to be fetched

curl -i -X GET \
  'https://innovario.apishowdown.com/_mock/catalog/api-showdown/api-hub/pet-store/openapi/store/order/{orderId}'

Responses

successful operation

Body
idinteger(int64)
Example: 10
petIdinteger(int64)
Example: 198772
quantityinteger(int32)
Example: 7
shipDatestring(date-time)
statusstring

Order Status

Enum"placed""approved""delivered"
Example: "approved"
completeboolean
Response
<order>
  <id>10</id>
  <petId>198772</petId>
  <quantity>7</quantity>
  <shipDate>2019-08-24T14:15:22Z</shipDate>
  <status>approved</status>
  <complete>true</complete>
</order>

Request

For valid response try integer IDs with value < 1000. Anything above 1000 or nonintegers will generate API errors

Path
orderIdinteger(int64)required

ID of the order that needs to be deleted

curl -i -X DELETE \
  'https://innovario.apishowdown.com/_mock/catalog/api-showdown/api-hub/pet-store/openapi/store/order/{orderId}'

Responses

Invalid ID supplied

Operations