Skip to content

Powered by Grav

Store

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

© 2026 Grav. All rights reserved.