---
title: "List account orders"
method: GET
path: "/orders"
tags: ["Commerce"]
---

# List account orders

`GET /orders`

## Request

- Base URL: `https://nautilinks.co/api/v1/agent`
- URL: `https://nautilinks.co/api/v1/agent/orders`
- Auth: HTTP bearer

Lists orders owned by the API-key account, newest state included.

## Response `200`

Order summaries.

- OrderListResponse
  - `ok` true, required
  - `count` integer, required
  - `orders` OrderSummary[], required
    - `id` string, required
    - `status` string, required
    - `total_eur` number, required
    - `created_at` string, required
    - `items_count` integer, required

## Other responses

- `401`: The API key is missing, invalid, or revoked.
- `403`: The key lacks the required scope or resource ownership.
- `429`: The request quota or rolling daily order cap was reached.
- `500`: Nautilinks encountered an unexpected internal error.
- `default`: Any non-success status not listed explicitly uses the same typed error envelope.

---

[API](https://skmtc.dev/nautilinks/apis/nautilinks-agent-api.md) · [All operations](https://skmtc.dev/nautilinks/apis/nautilinks-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nautilinks/apis/nautilinks-agent-api/revisions/7a2b1a00e40c?raw)
