Get domain

curl --request GET \
  --url https://api.coldsend.pro/api/public/v1/domains/{domain_id} \
  --header 'X-API-Key: <api-key>'

{
  "domain_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "domain_name": "<string>",
  "status": "<string>",
  "mailcow_added": true,
  "cloudflare_verified": true,
  "max_inboxes": 123,
  "current_inboxes": 123,
  "created_at": "<string>",
  "nameservers": [
    "<string>"
  ],
  "dns_records": [
    {
      "type": "<string>",
      "name": "<string>",
      "value": "<string>",
      "ttl": 123,
      "priority": 123
    }
  ],
  "updated_at": "<string>"
}

Domains

Get domain

Get detailed domain information

Retrieve complete details about a specific domain including configuration status and DNS records.

Response Includes

Domain identification and status
Nameservers to configure
DNS records (SPF, DKIM, MX)
Inbox capacity

Example Usage

import requests

domain_id = "550e8400-e29b-41d4-a716-446655440000"

response = requests.get(
    f"https://api.coldsend.io/api/public/v1/domains/{domain_id}",
    headers={"X-API-Key": "your-api-key"}
)

print(response.json())

GET

api

public

domains

{domain_id}

Get domain

curl --request GET \
  --url https://api.coldsend.pro/api/public/v1/domains/{domain_id} \
  --header 'X-API-Key: <api-key>'

{
  "domain_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "domain_name": "<string>",
  "status": "<string>",
  "mailcow_added": true,
  "cloudflare_verified": true,
  "max_inboxes": 123,
  "current_inboxes": 123,
  "created_at": "<string>",
  "nameservers": [
    "<string>"
  ],
  "dns_records": [
    {
      "type": "<string>",
      "name": "<string>",
      "value": "<string>",
      "ttl": 123,
      "priority": 123
    }
  ],
  "updated_at": "<string>"
}

Authorizations

X-API-Key

string

header

required

API key with format cs_live_xxx

Path Parameters

domain_id

string<uuid>

required

Response

Domain retrieved successfully

Detailed domain response.

domain_id

string<uuid>

required

Domain ID

domain_name

string

required

Domain name

status

string

required

Domain status

mailcow_added

boolean

required

Whether added to Mailcow

cloudflare_verified

boolean

required

Whether Cloudflare is verified

max_inboxes

integer

required

Maximum inboxes allowed

current_inboxes

integer

required

Current inbox count

created_at

string

required

Creation timestamp

nameservers

string[] | null

Nameservers to use

dns_records

DomainDNSRecord · object[] | null

DNS records to configure

Show child attributes

updated_at

string | null

Last update timestamp

Add domain Delete domain