Skip to content

API: Orders

← API overview

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.

ParameterInTypeRequiredNotes
limitqueryintegernomin 1, max 100, default 25
offsetqueryintegernomin 0, max 9007199254740991, default 0
Terminal window
curl -X GET "https://api.maildeck.co/v1/orders" \
-H "Authorization: Bearer $MAILDECK_API_KEY"

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

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

ParameterInTypeRequiredNotes
order_idpathstringyesFrom list_orders or get_checkout
Terminal window
curl -X GET "https://api.maildeck.co/v1/orders/<order_id>" \
-H "Authorization: Bearer $MAILDECK_API_KEY"