跳到内容
Esc
↑↓导航↵打开⌘J预览

List domains

Newest first, with cursor pagination: after takes the last id of a page and pages toward older items, before takes the first id and pages back toward newer ones. The team’s subdomain of the shared domain, when it has one, is the last row (shared: true).

GET/domains
授权
AuthorizationBearer 令牌 · header必填

A BillionSend API key (bs_…).

查询参数
limitinteger

Page size, 1-100 (default 20)

最小值 1 · 最大值 100
afterstring<uuid>

Cursor: id of the last item of the current page; returns the next page. Must be an id this list returned; there is no sentinel value.

beforestring<uuid>

Cursor: id of the first item of the current page; returns the previous page; same rule as after.

响应
200

Domains

objectstring必填
允许值:list
dataobject[]必填
显示属性
object 数组
idstring<uuid>必填
namestring必填
statusstring必填
created_atstring必填
regionstring必填
open_trackingboolean必填
click_trackingboolean必填
tracking_subdomainstring | null必填
tracking_statusstring | null必填

BillionSend extension: where the tracking subdomain stands: pending (waiting for its CNAME and certificate), active (links go through it) or failed (did not activate within 72 hours; links use the shared host). null while no tracking_subdomain is set.

允许值:pendingactivefailednull
tracking_errorstring | null必填

BillionSend extension: why the tracking subdomain is not active, when known

unsubscribe_subdomainstring | null必填

BillionSend extension: the domain's own unsubscribe host label, null when unset

unsubscribe_statusstring | null必填

BillionSend extension: where the unsubscribe subdomain stands: pending, active (unsubscribe links go through it) or failed (links use the shared host). null while no unsubscribe_subdomain is set. When both subdomains are the same label they share one host and always read the same.

允许值:pendingactivefailednull
unsubscribe_errorstring | null必填

BillionSend extension: why the unsubscribe subdomain is not active, when known

unsubscribe_pageobject必填

BillionSend extension: this domain's own look for its unsubscribe pages. A null field falls back to the team's default page, then to the built-in default.

显示属性
brand_namestring | null必填
messagestring | null必填
success_messagestring | null必填
redirect_urlstring | null必填
background_colorstring | null必填
text_colorstring | null必填
accent_colorstring | null必填
logo_radiusstring | null必填
允许值:squaregentleroundedcirclenull
logo_urlstring | null必填

Read-only; uploaded in the dashboard

capabilitiesobject必填
显示属性
sendingstring必填

enabled; on the shared row, disabled while sending from the shared domain is paused

receivingstring必填

enabled while the domain receives mail

receiving_catch_allboolean必填

BillionSend extension: whether mail to an address without an inbox is stored (true) or refused at RCPT (false)

sharedboolean必填

BillionSend extension: true on the team's subdomain of the shared inbox domain, a read-only row listed after the team's own domains (403 on changes) that POST /inboxes domain_id takes; false on the team's own domains

sending_modestring

BillionSend extension, on the shared row only: what its inboxes' addresses may send. open starts conversations, reply_only replies inside their threads, receive_only sends nothing. Holds on names still apply per send: an address whose username or from_name imitates a brand, or one on an older label that does, replies only, even when the mode is open.

允许值:openreply_onlyreceive_only
sending_mode_reasonstring | null

BillionSend extension, on the shared row only: what holds sending below open: plan when the team's plan holds it, the other value when the platform's sending switches do; null when open

允许值:planinstancenull
has_moreboolean必填
401

Missing, malformed, unknown or revoked API key

statusCodenumber必填
namestring必填
messagestring必填
422

Validation error

statusCodenumber必填
namestring必填
messagestring必填
429

Over the rate limit (rate_limit_exceeded, with Retry-After)

statusCodenumber必填
namestring必填
messagestring必填
试一试
服务器
授权
参数
请求
curl -X GET 'https://api.billionsend.com/domains' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'
响应
{
  "object": "list",
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "status": "string",
      "created_at": "string",
      "region": "string",
      "open_tracking": true,
      "click_tracking": true,
      "tracking_subdomain": "string",
      "tracking_status": "pending",
      "tracking_error": "string",
      "unsubscribe_subdomain": "string",
      "unsubscribe_status": "pending",
      "unsubscribe_error": "string",
      "unsubscribe_page": {
        "brand_name": "string",
        "message": "string",
        "success_message": "string",
        "redirect_url": "string",
        "background_color": "string",
        "text_color": "string",
        "accent_color": "string",
        "logo_radius": "square",
        "logo_url": "string"
      },
      "capabilities": {
        "sending": "string",
        "receiving": "string"
      },
      "receiving_catch_all": true,
      "shared": true,
      "sending_mode": "open",
      "sending_mode_reason": "plan"
    }
  ],
  "has_more": true
}

这个页面有帮助吗?