Skip to main content
GET
/
domains
List Domains
curl --request GET \
  --url https://app.lettr.com/api/domains \
  --header 'Authorization: Bearer <token>'
{
  "message": "Domains retrieved successfully.",
  "data": {
    "domains": [
      {
        "domain": "example.com",
        "status": "approved",
        "status_label": "Approved",
        "can_send": true,
        "cname_status": "valid",
        "dkim_status": "valid",
        "created_at": "2024-01-15T10:30:00+00:00",
        "updated_at": "2024-01-16T14:45:00+00:00"
      },
      {
        "domain": "pending.example.com",
        "status": "pending",
        "status_label": "Pending Review",
        "can_send": false,
        "cname_status": null,
        "dkim_status": null,
        "created_at": "2024-01-17T09:00:00+00:00",
        "updated_at": "2024-01-17T09:00:00+00:00"
      }
    ]
  }
}
Returns all sending domains configured for your team, including their verification status and DNS record information.

Authorizations

​
Authorization
string
header
required

API key for authentication

Response

List of domains retrieved successfully

Response containing a list of domains

​
message
string
required

Human-readable response message

Example:

"Domains retrieved successfully."

​
data
object
required