Orders API

Handle customer orders with the Nevuto API.

Orders are created when customers complete a checkout. You can list, retrieve, and manage orders through the API.

List Orders

GET /v1/stores/:storeId/orders

Get an Order

GET /v1/orders/:id

Response:

{
  "data": {
    "id": "order_xyz789",
    "storeId": "store_abc123",
    "status": "paid",
    "total": 2999,
    "currency": "USD",
    "customer": {
      "email": "[email protected]",
      "name": "John Doe"
    },
    "lineItems": [
      {
        "productId": "prod_def456",
        "name": "Premium T-Shirt",
        "quantity": 1,
        "price": 2999
      }
    ],
    "createdAt": "2026-04-02T14:30:00Z"
  }
}

Update Order Status

PUT /v1/orders/:id

{
  "status": "fulfilled"
}

Order Statuses