Swagger Petstore - OpenAPI 3.0
POST/store/order

Place an order for a pet

Creates a new order in the store for a pet. You can provide order details such as petId, quantity, shipDate, and status; status, if supplied, must be placed, approved, or delivered. A 200 response returns the order record.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

6 body fields

Optional order details. Send the body as JSON, XML, or URL-encoded form data.

idintegeroptional
The order's numeric identifier.
petIdintegeroptional
The numeric identifier of the pet in the order.
quantityintegeroptional
The number of pets in the order.
shipDatestringoptional
The order's shipping date and time in date-time format.
statusstringoptional
Order Status
Allowed:placedapproveddelivered
completebooleanoptional
Whether the order is complete.

4 status codes
200Returns the order record, including its identifier, pet identifier, quantity, ship date, status, and completion flag.
idintegeroptional
petIdintegeroptional
quantityintegeroptional
shipDatestringoptional
statusstringoptional
Order Status
Allowed:placedapproveddelivered
completebooleanoptional
400Returned when the input is invalid.
422Returned when validation fails.
defaultReturned when an unexpected error occurs.

Error handling

A 400 is returned for invalid input, and a 422 is returned when validation fails. shipDate, if provided, must use date-time format; status, if provided, must be one of placed, approved, or delivered.