Skip to main content
GET
/
orders
List Orders
curl --request GET \
  --url https://api.example.com/orders
[
  {
    "id": 42,
    "userId": 5,
    "total": "149.97",
    "status": "delivered",
    "createdAt": "2026-03-01T10:30:00.000Z",
    "updatedAt": "2026-03-04T14:20:00.000Z",
    "items": [
      {
        "id": 101,
        "orderId": 42,
        "productId": 15,
        "quantity": 2,
        "priceAtPurchase": "49.99",
        "product": {
          "id": 15,
          "name": "Wireless Headphones",
          "description": "High-quality Bluetooth headphones",
          "price": "54.99",
          "imageUrl": "https://example.com/images/headphones.jpg",
          "stock": 25,
          "categoryId": 3
        }
      },
      {
        "id": 102,
        "orderId": 42,
        "productId": 23,
        "quantity": 1,
        "priceAtPurchase": "49.99",
        "product": {
          "id": 23,
          "name": "USB-C Cable",
          "description": "Fast charging cable",
          "price": "49.99",
          "imageUrl": "https://example.com/images/cable.jpg",
          "stock": 100,
          "categoryId": 3
        }
      }
    ]
  },
  {
    "id": 38,
    "userId": 5,
    "total": "79.99",
    "status": "pending",
    "createdAt": "2026-02-28T15:45:00.000Z",
    "updatedAt": "2026-02-28T15:45:00.000Z",
    "items": [
      {
        "id": 95,
        "orderId": 38,
        "productId": 8,
        "quantity": 1,
        "priceAtPurchase": "79.99",
        "product": {
          "id": 8,
          "name": "Mechanical Keyboard",
          "description": "RGB backlit gaming keyboard",
          "price": "79.99",
          "imageUrl": "https://example.com/images/keyboard.jpg",
          "stock": 15,
          "categoryId": 3
        }
      }
    ]
  }
]
Retrieves a list of all orders placed by the authenticated user, ordered by creation date (most recent first). Each order includes its items and associated product details.

​
Authentication

This endpoint requires authentication. Include a valid JWT token in the Authorization header. 
Authorization: Bearer <your-token>

​
Response

Returns an array of order objects.
​
id
number
required
Unique identifier for the order
​
userId
number
required
ID of the user who placed the order
​
total
string
required
Total amount for the order (decimal as string)
​
status
string
required
Current status of the orderPossible values:
  • pending - Order has been created but not yet processed
  • shipped - Order has been shipped
  • delivered - Order has been delivered
  • cancelled - Order has been cancelled
​
createdAt
string
required
ISO 8601 timestamp when the order was created
​
updatedAt
string
required
ISO 8601 timestamp when the order was last updated
​
items
array
required
Array of order items
​
id
number
required
Unique identifier for the order item
​
orderId
number
required
ID of the parent order
​
productId
number
required
ID of the product
​
quantity
number
required
Quantity of the product ordered
​
priceAtPurchase
string
required
Price of the product at the time of purchase (decimal as string)
​
product
object
required
Product details
​
id
number
required
Product ID
​
name
string
required
Product name
​
description
string
Product description
​
price
string
required
Current price of the product (decimal as string)
​
imageUrl
string
required
URL to the product image
​
stock
number
required
Current stock level
​
categoryId
number
ID of the product’s category
[
  {
    "id": 42,
    "userId": 5,
    "total": "149.97",
    "status": "delivered",
    "createdAt": "2026-03-01T10:30:00.000Z",
    "updatedAt": "2026-03-04T14:20:00.000Z",
    "items": [
      {
        "id": 101,
        "orderId": 42,
        "productId": 15,
        "quantity": 2,
        "priceAtPurchase": "49.99",
        "product": {
          "id": 15,
          "name": "Wireless Headphones",
          "description": "High-quality Bluetooth headphones",
          "price": "54.99",
          "imageUrl": "https://example.com/images/headphones.jpg",
          "stock": 25,
          "categoryId": 3
        }
      },
      {
        "id": 102,
        "orderId": 42,
        "productId": 23,
        "quantity": 1,
        "priceAtPurchase": "49.99",
        "product": {
          "id": 23,
          "name": "USB-C Cable",
          "description": "Fast charging cable",
          "price": "49.99",
          "imageUrl": "https://example.com/images/cable.jpg",
          "stock": 100,
          "categoryId": 3
        }
      }
    ]
  },
  {
    "id": 38,
    "userId": 5,
    "total": "79.99",
    "status": "pending",
    "createdAt": "2026-02-28T15:45:00.000Z",
    "updatedAt": "2026-02-28T15:45:00.000Z",
    "items": [
      {
        "id": 95,
        "orderId": 38,
        "productId": 8,
        "quantity": 1,
        "priceAtPurchase": "79.99",
        "product": {
          "id": 8,
          "name": "Mechanical Keyboard",
          "description": "RGB backlit gaming keyboard",
          "price": "79.99",
          "imageUrl": "https://example.com/images/keyboard.jpg",
          "stock": 15,
          "categoryId": 3
        }
      }
    ]
  }
]

​
Error Responses

​
401 Unauthorized

Returned when the authentication token is missing or invalid. 
{
  "error": "Usuario no autenticado"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us