List Orders

Get all orders for the authenticated user

GET /orders

List Orders

cURL

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 order

Possible 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"
}