---
title: "Get pre-warmed up domains"
method: POST
path: "/api/v2/dfy-email-account-orders/domains/pre-warmed-up-list"
tags: ["DFYEmailAccountOrder"]
---

# Get pre-warmed up domains

`POST /api/v2/dfy-email-account-orders/domains/pre-warmed-up-list`

## Request

- Base URL: `https://api.instantly.ai`
- URL: `https://api.instantly.ai/api/v2/dfy-email-account-orders/domains/pre-warmed-up-list`
- Auth: HTTP bearer

This endpoint will return a list of pre-warmed up domains available for order.<br/>These domains are set up and configured in advance, allowing for quick deployment of email services.<br/>Use this endpoint to retrieve available pre-warmed up domains before placing an order.<br/><br/><b>IMPORTANT: if the endpoint returns a list of empty domains - it's not a bug, please don't retry right away or report this as a bug - it simply means that there are no available pre-warmed up domains at the moment.</b>


Requires one of the following scopes: `dfy_email_account_orders:read`, `dfy_email_account_orders:all`, `all:read`, `all:all`

## Request body

- object: This endpoint does not require any parameters in the request body.
  - `extensions` string[]: A list of domain extensions to filter the results by. If not provided, all available extensions will be returned.
  - `search` string: A search string to filter the domains by. This can be a partial or full domain name.

## Response `200`

Default Response

- object
  - `domains` string[]: List of pre-warmed up domains available for order
  - `domains_with_type` object[]: Pre-warmed up domains annotated with their underlying email provider
    - `domain` string, required
    - `account_type` 1 | 2 | 3, required: The mailbox product to order. Defaults to Google when omitted. Options: - 1: Google. Up to 5 mailboxes per domain; priced per mailbox monthly. - 2: AirMail. Up to 5 mailboxes per domain; priced per mailbox monthly. - 3: Microsoft/Outlook. 50-100 mailboxes per new DFY domain; priced per domain monthly.

## Other responses

- `401`: This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked)
- `402`: This request cannot be fulfilled because the workspace does not have an active paid plan
- `404`: The requested resource was not found
- `429`: You have exceeded the rate limit. Please check the rate limit docs for more information.

---

[API](https://skmtc.dev/instantly/apis/api-explorer.md) - [All operations](https://skmtc.dev/instantly/apis/api-explorer/llms.txt) - [OpenAPI document](https://skmtc.dev/instantly/apis/api-explorer/revisions/adcd5b3299da?raw)