Orders

Place and manage customer orders.

List orders

get

https://petstore.example.com/v1https://staging.petstore.example.com/v1

/store/orders

Returns all orders placed in the store. Does not currently support filtering or pagination.

Filtering and pagination are planned for v2. Subscribe to the changelog for updates.

授权

bearerAuth

Authorizationstring必填

Pass your API key as a Bearer token in the Authorization header.

响应

200

An array of orders.

application/json

idinteger · int64可选

Unique order identifier.

petIdinteger · int64可选

The ID of the animal in this order.

quantityinteger可选

Number of units ordered.

shipDatestring · date-time可选

Expected or actual ship date in ISO 8601 format.

completeboolean可选

Whether the order has been fulfilled.

401

Missing or invalid API key.

application/json

get

/store/orders

CLIFetchPython

curl -L https://petstore.example.com/v1/store/orders \
  -H 'Authorization: Bearer YOUR_API_KEY'

[
  {
    "id": 1,
    "petId": 1,
    "quantity": 1,
    "shipDate": "2026-06-05T03:16:24.382Z",
    "complete": true
  }
]

Beta

Cancel an order

delete

https://petstore.example.com/v1https://staging.petstore.example.com/v1

/store/orders/{orderId}

Cancels an order by ID. Only orders with a status of pending can be cancelled — orders that have already shipped cannot be reversed.

授权

bearerAuth

Authorizationstring必填

Pass your API key as a Bearer token in the Authorization header.

路径参数

orderIdinteger · int64必填

The ID of the order to cancel.

响应

204

Order cancelled successfully.

401

Missing or invalid API key.

application/json

404

The requested resource could not be found.

application/json

409

Order cannot be cancelled — it has already shipped.

delete

/store/orders/{orderId}

CLIFetchPython

curl -L -X DELETE https://petstore.example.com/v1/store/orders/42 \
  -H 'Authorization: Bearer YOUR_API_KEY'

无内容