# API: Orders

> Orders operations of the Maildeck API: list_orders, get_order.

Source: https://docs.maildeck.co/api/orders/

[← API overview](https://docs.maildeck.co/api/)

## list_orders

`GET /v1/orders` · scope: **read** · MCP tool: `list_orders`

The account's orders, newest first.

One entry per purchase. needs_setup is true while a paid order is waiting for its domains and logins (see get_order_setup). estimated_ready_at appears once setup is complete.

| Parameter | In | Type | Required | Notes |
|---|---|---|---|---|
| `limit` | query | integer | no | min 1, max 100, default `25` |
| `offset` | query | integer | no | min 0, max 9007199254740991, default `0` |

```bash
curl -X GET "https://api.maildeck.co/v1/orders" \
  -H "Authorization: Bearer $MAILDECK_API_KEY"
```

## get_order

`GET /v1/orders/{order_id}` · scope: **read** · MCP tool: `get_order`

One order: what was bought, setup status and when it will be ready.

| Parameter | In | Type | Required | Notes |
|---|---|---|---|---|
| `order_id` | path | string | yes | From list_orders or get_checkout |

```bash
curl -X GET "https://api.maildeck.co/v1/orders/<order_id>" \
  -H "Authorization: Bearer $MAILDECK_API_KEY"
```
