For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Help CenterAPI KeysStatusSign In
GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelog
  • Introduction
    • Getting started
  • Email API
  • Transactional SMS
  • Transactional WhatsApp
  • Marketing Campaigns
  • Contact Management
  • Events
    • GETGet events
    • POSTCreate an event
    • POSTCreate events in batch
  • Object Management
  • Accounts and Settings
      • GETGet the list of all sender domains
      • POSTCreate a new sender domain
      • DELDelete a sender domain
      • GETGet a sender domain configuration
      • PUTAuthenticate a sender domain
  • Sales CRM
  • Conversations
  • Ecommerce
  • Loyalty
LogoLogo
Help CenterAPI KeysStatusSign In
Accounts and SettingsDomains

Get the list of all sender domains

GET
https://api.brevo.com/v3/senders/domains
GET
/v3/senders/domains
1import { BrevoClient } from "@getbrevo/brevo";
2
3async function main() {
4    const client = new BrevoClient({
5        apiKey: "YOUR_API_KEY_HERE",
6    });
7    await client.domains.getDomains();
8}
9main();
1{
2  "domains": [
3    {
4      "id": "67e57b40130375f045064c45",
5      "domain_name": "mycompany.com",
6      "authenticated": true,
7      "verified": true,
8      "provider": "Cloudflare",
9      "creator": {
10        "id": "62e4fce597550d0b0177cb0c",
11        "email": "admin@mycompany.com",
12        "creationDate": "2025-03-27T16:22:24+00:00"
13      },
14      "ip": "192.168.1.100"
15    },
16    {
17      "id": "67f778570dd65f97c70910ed",
18      "domain_name": "newsletter.mycompany.com",
19      "authenticated": false,
20      "verified": true,
21      "provider": "GoDaddy",
22      "creator": {
23        "id": "62e4fce597550d0b0177cb0c",
24        "email": "admin@mycompany.com",
25        "creationDate": "2025-04-10T07:50:47+00:00"
26      },
27      "ip": null
28    },
29    {
30      "id": "688cd306d8893504e50ea615",
31      "domain_name": "test.example.com",
32      "authenticated": false,
33      "verified": false,
34      "provider": "Other",
35      "creator": {
36        "id": "62e4fce597550d0b0177cb0c",
37        "email": "admin@mycompany.com",
38        "creationDate": "2025-08-01T14:45:26+00:00"
39      },
40      "ip": null
41    }
42  ],
43  "count": 3,
44  "current_page": 1,
45  "total_pages": 1
46}
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
Was this page helpful?
Previous

Create a new sender domain

Next
Built with

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.

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