Skip to main content
GET
/
v1
/
domains
Get domains
curl --request GET \
  --url https://brew.new/api/v1/domains \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "domainId": "kx7bkh53hasmfeh5kd7sqgykt187g8ww",
      "domainUrl": "https://send.example.com",
      "name": "send.example.com",
      "region": "us-east-1",
      "status": "pending",
      "sendingEnabled": true,
      "sendable": false,
      "records": [
        {
          "record": "DKIM",
          "name": "resend._domainkey",
          "type": "TXT",
          "ttl": "Auto",
          "status": "pending",
          "value": "p=MIGfMA0..."
        }
      ],
      "createdAt": "2026-04-08T12:34:56.789Z",
      "updatedAt": "2026-04-08T12:34:56.789Z"
    }
  ],
  "pagination": {
    "limit": 100,
    "cursor": null,
    "hasMore": false
  }
}

Authorizations

​
Authorization
string
header
default:Bearer brew_your_api_key
required

Send your Brew API key as Authorization: Bearer brew_xxx.

Query Parameters

​
domainId
string

Fetch a single domain by id (detail mode → { data: [row] }). Omit to list.

Required string length: 1 - 64
​
sendableOnly
enum<string>

List mode only — when true, only verified send-ready domains.

Available options:
true,
false
​
limit
integer

Page size (1–100). Defaults to 100.

Required range: 1 <= x <= 100
​
cursor
string

Opaque pagination cursor echoed from the previous page’s pagination.cursor. Omit for the first page.

Required string length: 1 - 512

Response

A page of domains (list mode), or { data: [row] } (detail mode).

​
data
object[]
required
​
pagination
object