List Email Addresses

---

Return the email addresses the company can receive mail at. Like Assign Email Address, this is called with a company token, not the partner JWT, and the company must have an active ADMIN user.

Endpoint

Property	Value
URL	GET /smtp/account/{companyId}/email-addresses
Method	GET
Auth	R-Auth: <company-jwt> (Administrator role required)
Base URL	Stage Environment https://api-stage.docnova.ai/ Production Environment https://api.docnova.ai/

Example Request

curl --location '{{baseUrl}}/smtp/account/{{companyId}}/email-addresses' \
--header 'R-Auth: {{companyJwt}}'

Path parameters

Parameter	Type	Required	Description
companyId	UUID	Yes	Company UUID

Request fields

This endpoint takes no parameters or request body besides the path parameter above.

Response

[
  {
    "emailAddress": "sales-team@mail.example.com",
    "active": true,
    "lastEmailReceivedAt": "2026-01-15T12:00:00.000Z"
  }
]

Response fields

Field	Type	Description
emailAddress	string	The assigned email address
active	boolean	Whether the address is active
lastEmailReceivedAt	string (ISO 8601)	Time the address last received an email

Response Codes

Code	Description
200	OK — Returns the company's assigned email addresses
401	Unauthorized — R-Auth header missing or invalid
403	Forbidden — Company does not have an active ADMIN user