Skip to main content
GET
/
v1
/
domains
List Domains
curl --request GET \
  --url https://api.example.com/v1/domains

​
List Domains

Retrieve a list of all domains in your account.
​
limit
integer
default:"10"
Number of domains to return. Maximum 100.
​
starting_after
string
Cursor for pagination.
​
status
string
Filter by status: pending, verified, failed.

​
Request

curl "https://api.lettr.dev/v1/domains?limit=10" \
  -H "Authorization: Bearer le_xxxxxxxxxxxx"

​
Response

{
  "object": "list",
  "data": [
    {
      "id": "dom_123abc",
      "object": "domain",
      "name": "example.com",
      "status": "verified",
      "region": "us",
      "spfStatus": "verified",
      "dkimStatus": "verified",
      "dmarcStatus": "verified",
      "createdAt": "2024-01-15T10:30:00Z"
    },
    {
      "id": "dom_456def",
      "object": "domain",
      "name": "mail.example.com",
      "status": "pending",
      "region": "us",
      "spfStatus": "pending",
      "dkimStatus": "pending",
      "dmarcStatus": "pending",
      "createdAt": "2024-01-14T08:00:00Z"
    }
  ],
  "hasMore": false,
  "totalCount": 2
}