---
title: "List done-for-you orders"
method: GET
path: "/dfy/orders"
tags: ["DoneForYou"]
---

# List done-for-you orders

`GET /dfy/orders`

## Request

- Base URL: `https://api.emailchaser.com/r`
- URL: `https://api.emailchaser.com/r/dfy/orders`
- Auth: HTTP bearer

Lists the workspace's done-for-you orders, newest first. Each order carries the same fields as GET /dfy/orders/{id}: status, cost breakdown and the caller-supplied order shape; internal billing and provider sub-records are never exposed.

## Query parameters

- `limit` integer
- `page` integer

## Response `200`

Orders and total count

- ModelsListDfyOrdersResponse
  - `orders` ModelsDfyOrderResponse[]
    - `completedAt` string: CompletedAt is when the order completed (RFC3339), or null.
    - `cost_breakdown` unknown
    - `createdAt` string
    - `domains` unknown
    - `externalOrderId` string
    - `failureReason` string
    - `forwardingDomain` unknown
    - `id` integer
    - `mailboxes` unknown
    - `processedAt` string: ProcessedAt is when the order started processing (RFC3339), or null.
    - `status` string: Status is one of: created, pending_approval, processing, completed, failed, partially_completed, canceled.
  - `total` integer

## Other responses

- `401`: Unauthorized - invalid or missing API key
- `500`: Failed to retrieve the orders

---

[API](https://skmtc.dev/emailchaser/apis/emailchaser-api.md) · [All operations](https://skmtc.dev/emailchaser/apis/emailchaser-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emailchaser/apis/emailchaser-api/revisions/8b114990abb7?raw)