- Zapmail Docs
- users
- workspaces
- billing
- mailbox
- payments & wallet
- export
- subscriptions
- domains
- Retrieve All DomainsGET
- List Assignable DomainsGET
- Add DMARC recordPOST
- Add Domain forwardingPOST
- Get Name servers to connect domainPOST
- Verify Name Server PropagationPOST
- Connect Domain with ZapmailPOST
- Enable email forwardingPOST
- Remove email forwardingDELETE
- Enable catch all emailsPOST
- Remove catch all emailsDELETE
- Check DNS recordsPOST
- Remove unused domainsDELETE
- Get available domains for registrationPOST
- Get domains purchase payment linkPOST
Retrieve All Mailboxes
GET
/v1/mailbox/list
Request
Header Params
x-auth-zapmail
string
required
Example:
{{x-auth-zapmail}}
Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.zapmail.ai/api/v1/mailbox/list' \
--header 'x-auth-zapmail: '
Responses
🟢200Success
application/json
Body
object {0}
Example
{
"status": 200,
"message": "Mailboxes fetched successfully",
"data": {
"totalSearchedCount": 50,
"currentPage": 1,
"nextPage": 2,
"totalPages": 2,
"purchasedMailboxes": 500,
"totalAssignedMailboxes": 20,
"totalActiveMailboxes": 10,
"availableMailboxes": 480,
"domains": [
{
"id": "12345abc-defg-6789-hijk-lmnopqrstu12",
"domain": "example1.com",
"status": "ACTIVE",
"mailboxes": [
{
"id": "abcd1234-5678-90ef-ghij-klmn12345678",
"username": "john.doe",
"firstName": "John",
"lastName": "Doe",
"status": "ACTIVE",
"profilePicture": null,
"domain": "example1.com",
"domainId": "12345abc-defg-6789-hijk-lmnopqrstu12",
"assignedOn": "2025-01-10T09:00:00.000Z",
"expireOn": "2025-02-10T09:00:00.000Z",
"createdAt": "2025-01-10T09:00:00.000Z"
}
]
},
{
"id": "6789xyz-wxyz-4567-klmn-7890abcdef12",
"domain": "example2.net",
"status": "ACTIVE",
"mailboxes": [
{
"id": "xyz1234-5678-90ab-cdef-ghijk9876543",
"username": "jane.smith",
"firstName": "Jane",
"lastName": "Smith",
"status": "IN_PROGRESS",
"profilePicture": null,
"domain": "example2.net",
"domainId": "6789xyz-wxyz-4567-klmn-7890abcdef12",
"assignedOn": "2025-01-12T11:00:00.000Z",
"expireOn": "2025-02-12T11:00:00.000Z",
"createdAt": "2025-01-12T11:00:00.000Z"
}
]
}
]
}
}