---
title: "Get a done-for-you order"
method: GET
path: "/dfy/orders/{id}"
tags: ["DoneForYou"]
---

# Get a done-for-you order

`GET /dfy/orders/{id}`

## Request

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

Returns one order. Orders belonging to other workspaces are reported as not found.

## Path parameters

- `id` integer, required

## Response `200`

The order

- ModelsDfyOrderResult
  - `order` 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.

## Other responses

- `400`: Invalid order id
- `401`: Unauthorized - invalid or missing API key
- `404`: Order not found
- `500`: Failed to retrieve the order

---

[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)