Get the list of all sender domains

GET

https://api.brevo.com/v3/senders/domains

GET

/v3/senders/domains

import { BrevoClient } from "@getbrevo/brevo";
async function main() {
    const client = new BrevoClient({
        apiKey: "YOUR_API_KEY_HERE",
    });
    await client.domains.getDomains();
}
main();

{
  "domains": [
    {
      "id": "67e57b40130375f045064c45",
      "domain_name": "mycompany.com",
      "authenticated": true,
      "verified": true,
      "provider": "Cloudflare",
      "creator": {
        "id": "62e4fce597550d0b0177cb0c",
        "email": "admin@mycompany.com",
        "creationDate": "2025-03-27T16:22:24+00:00"
      },
      "ip": "192.168.1.100"
    },
    {
      "id": "67f778570dd65f97c70910ed",
      "domain_name": "newsletter.mycompany.com",
      "authenticated": false,
      "verified": true,
      "provider": "GoDaddy",
      "creator": {
        "id": "62e4fce597550d0b0177cb0c",
        "email": "admin@mycompany.com",
        "creationDate": "2025-04-10T07:50:47+00:00"
      },
      "ip": null
    },
    {
      "id": "688cd306d8893504e50ea615",
      "domain_name": "test.example.com",
      "authenticated": false,
      "verified": false,
      "provider": "Other",
      "creator": {
        "id": "62e4fce597550d0b0177cb0c",
        "email": "admin@mycompany.com",
        "creationDate": "2025-08-01T14:45:26+00:00"
      },
      "ip": null
    }
  ],
  "count": 3,
  "current_page": 1,
  "total_pages": 1
}

Retrieves all domains associated with the account.

Use this to:

List all domains
Verify domain existence
Check domain authentication and verification status
Monitor domain configuration and provider information
Review domain creation history and ownership

Key information returned:

Domain details (ID, name, authentication status)
Verification and authentication states
Associated IP addresses and DNS providers
Creator information and creation timestamps
Pagination information for large domain lists

Authentication

api-keystring

The API key should be passed in the request headers as api-key for authentication.

AuthorizationBearer

OAuth 2.0 client_credentials (machine-to-machine) grant. Exchange your app’s client_id/client_secret for a short-lived Bearer token.

Response

List of domains retrieved successfully

domainslist of objects

List of the domains available in your account

countinteger

Total number of domains

current_pageinteger

Current page number

total_pagesinteger

Total number of pages

Errors

400

Bad Request Error