Skip to main content
GET
/
v1
/
domains
/
{id}
Get Domain
curl --request GET \
  --url https://api.example.com/v1/domains/{id}

​
Get Domain

Retrieve details of a specific domain by its ID.
​
id
string
required
The ID of the domain to retrieve.

​
Request

curl https://api.lettr.dev/v1/domains/dom_123abc \
  -H "Authorization: Bearer le_xxxxxxxxxxxx"

​
Response

{
  "id": "dom_123abc",
  "object": "domain",
  "name": "example.com",
  "status": "verified",
  "region": "us",
  "dnsRecords": [
    {
      "type": "TXT",
      "host": "@",
      "value": "v=spf1 include:spf.lettr.dev ~all",
      "purpose": "spf",
      "verified": true
    },
    {
      "type": "CNAME",
      "host": "lettr._domainkey",
      "value": "dkim.lettr.dev",
      "purpose": "dkim",
      "verified": true
    },
    {
      "type": "TXT",
      "host": "_dmarc",
      "value": "v=DMARC1; p=none;",
      "purpose": "dmarc",
      "verified": true
    }
  ],
  "spfStatus": "verified",
  "dkimStatus": "verified",
  "dmarcStatus": "verified",
  "trackingDomain": "links.example.com",
  "trackingDomainStatus": "verified",
  "createdAt": "2024-01-15T10:30:00Z",
  "verifiedAt": "2024-01-15T12:00:00Z"
}

​
Domain Status

StatusDescription
pendingWaiting for DNS verification
verifiedAll DNS records verified
failedVerification failed