Store
Endpoints for managing store inventory and purchase orders.
Access the pet store's current inventory, place new purchase orders, look up existing orders by id, and delete orders that are no longer needed. Inventory requests are available to everyone; order endpoints require an authenticated session.
Get Inventory
GET
/store/inventory
Returns a map of status codes to quantities of pets currently in the store.
JSON
{
"available": 42,
"pending": 7,
"sold": 15
}
Response Codes
200
Successful operation
Place Order
POST
/store/order
Place a new order for a pet.
Parameters
| Name | Type | Description |
|---|---|---|
| petId required | integer | ID of the pet being ordered |
| quantity required | integer | Number of units to order |
| shipDate optional | string | ISO 8601 date-time for requested shipment |
| status optional | string | Order status: placed, approved, or delivered |
| complete optional | boolean | Whether the order has been fulfilled |
JSON
{
"petId": 198772,
"quantity": 1,
"shipDate": "2026-05-01T09:00:00.000Z",
"status": "placed",
"complete": false
}
JSON
{
"id": 10,
"petId": 198772,
"quantity": 1,
"shipDate": "2026-05-01T09:00:00.000Z",
"status": "placed",
"complete": false
}
Response Codes
200
Order placed
400
Invalid input
422
Validation exception
Get Order by ID
GET
/store/order/{orderId}
Retrieve a purchase order by its ID. IDs between 1 and 10 are valid in the demo data set; IDs greater than 10 or non-integers generate API errors.
Parameters
| Name | Type | Description |
|---|---|---|
| orderId required | integer | The ID of the order to fetch |
JSON
{
"id": 10,
"petId": 198772,
"quantity": 1,
"shipDate": "2026-05-01T09:00:00.000Z",
"status": "approved",
"complete": true
}
Response Codes
200
Successful operation
400
Invalid ID supplied
404
Order not found
Delete Order
DELETE
/store/order/{orderId}
Delete a purchase order by its ID. For valid response try integer IDs with positive values; negative or non-integer IDs will generate API errors.
Parameters
| Name | Type | Description |
|---|---|---|
| orderId required | integer | The ID of the order to delete |
Response Codes
200
Order deleted
400
Invalid ID supplied
404
Order not found