Get account details | Brevo API Documentation

1 import requests 2 3 url = "https://api.brevo.com/v3/account" 4 5 headers = {"api-key": "<apiKey>"} 6 7 response = requests.get(url, headers=headers) 8 9 print(response.json())

1 { 2 "plan": [ 3 { 4 "credits": 250, 5 "creditsType": "sendLimit", 6 "type": "free" 7 }, 8 { 9 "credits": 15, 10 "creditsType": "sendLimit", 11 "type": "sms" 12 } 13 ], 14 "relay": { 15 "data": { 16 "port": 587, 17 "relay": "smtp-relay.brevo.com", 18 "userName": "michael.davis@example.com" 19 }, 20 "enabled": true 21 }, 22 "organization_id": "5fa2b8c123456789abcdef01", 23 "user_id": 1234567, 24 "enterprise": false, 25 "companyName": "Acme Marketing Corp", 26 "email": "michael.davis@example.com", 27 "firstName": "Michael", 28 "lastName": "Davis", 29 "address": { 30 "city": "New York", 31 "country": "United States", 32 "street": "456 Business Ave", 33 "zipCode": "10001" 34 }, 35 "dateTimePreferences": { 36 "timezone": "America/New_York", 37 "timeFormat": "12", 38 "dateFormat": "mm-dd-yyyy" 39 }, 40 "marketingAutomation": { 41 "enabled": true, 42 "key": "ma8k2x9v4h7p3d6f1c5e8b2a" 43 }, 44 "planVerticals": [ 45 { 46 "planCategory": "Marketing", 47 "planType": "free", 48 "name": "Free", 49 "status": "active", 50 "startDate": "1751234567", 51 "endDate": "1753826567", 52 "users": { 53 "purchasedSeats": "1", 54 "usedSeats": "1" 55 }, 56 "credits": "250" 57 }, 58 { 59 "planCategory": "Chat", 60 "planType": "free", 61 "name": "Free", 62 "status": "active", 63 "startDate": "1735678901", 64 "endDate": "1767214901", 65 "users": { 66 "purchasedSeats": "1", 67 "usedSeats": "1" 68 } 69 }, 70 { 71 "planCategory": "CRM", 72 "planType": "free", 73 "name": "Free", 74 "status": "active", 75 "startDate": "1735678900", 76 "endDate": "1767214900", 77 "users": { 78 "purchasedSeats": "1", 79 "usedSeats": "1" 80 } 81 } 82 ] 83 }

Retrieves details of your Brevo account.

Use this to:

Get account information (email, name, company, address)
Check plan details (type, credits, expiration)
Get relay information (for transactional emails)
Check Marketing Automation status
View date/time preferences and account settings
Access organization and user identifiers

Key information returned:

Complete account details (organization ID, user ID, company information)
Address and contact information
Plan configurations and credit allocations across different verticals
Marketing Automation settings and tracker key
SMTP relay configuration for transactional emails
Date/time preferences and account settings
Enterprise features availability status

Important considerations:

Provides comprehensive account overview for billing and configuration management
Essential for understanding current plan limitations and feature availability
Marketing Automation key required for advanced automation features
Plan verticals show detailed breakdown across Marketing, Chat, and CRM categories
Relay configuration crucial for transactional email setup and deliverability
Date/time preferences affect campaign scheduling and reporting displays
Enterprise status determines access to advanced features and sub-account management

Retrieves details of your Brevo account. **Use this to:** - Get account information (email, name, company, address) - Check plan details (type, credits, expiration) - Get relay information (for transactional emails) - Check Marketing Automation status - View date/time preferences and account settings - Access organization and user identifiers **Key information returned:** - Complete account details (organization ID, user ID, company information) - Address and contact information - Plan configurations and credit allocations across different verticals - Marketing Automation settings and tracker key - SMTP relay configuration for transactional emails - Date/time preferences and account settings - Enterprise features availability status **Important considerations:** - Provides comprehensive account overview for billing and configuration management - Essential for understanding current plan limitations and feature availability - Marketing Automation key required for advanced automation features - Plan verticals show detailed breakdown across Marketing, Chat, and CRM categories - Relay configuration crucial for transactional email setup and deliverability - Date/time preferences affect campaign scheduling and reporting displays - Enterprise status determines access to advanced features and sub-account management

Authentication

api-keystring

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

Response

Account information retrieved successfully

planlist of objects

Information about your plans and credits

relayobject

Information about your transactional email account

organization_idstring

Unique identifier for the organization

user_idinteger

Unique identifier for the user

enterpriseboolean

Indicates if the account has enterprise features

companyNamestring

Name of the company

emailstringformat: "email"

firstNamestring

First Name

lastNamestring

Last Name

addressobject

Address informations

dateTimePreferencesobject

User's date and time preferences

marketingAutomationobject or null

planVerticalslist of objects or null

Detailed information about different plan categories