Zapmail
latest
  • latest
  • v1
  1. workspaces
Zapmail
latest
  • latest
  • v1
  • Zapmail Docs
  • users
    • Retrieve User Details
      GET
  • workspaces
    • Retrieve all workspaces
      GET
    • Create new workspace
      POST
    • Update workspace
      PUT
  • billing
    • Add Billing Details
      POST
    • Update Billing Details
      PUT
  • mailbox
    • Retrieve All Mailboxes
      GET
    • Get Mailbox Details by ID
      GET
    • Assign New Mailboxes to Domains
      POST
    • Update mailbox
      PUT
    • Remove mailboxes on next renewal
      PUT
    • Get Authenticator code
      GET
    • Remove Mailboxes Instantly
      POST
  • payments & wallet
    • Add balance to wallet
      POST
    • Get wallet balance
      GET
    • Enable auto recharge
      POST
  • export
    • Export mailboxes
      POST
    • Add third party account details
      POST
    • Update third party account details
      PUT
  • subscriptions
    • Get all subscriptions
      GET
    • Cancel subscription
      POST
    • Upgrade existing subscription
      POST
  • domains
    • Retrieve All Domains
    • List Assignable Domains
    • Add DMARC record
    • Add Domain forwarding
    • Get Name servers to connect domain
    • Verify Name Server Propagation
    • Connect Domain with Zapmail
    • Enable email forwarding
    • Remove email forwarding
    • Enable catch all emails
    • Remove catch all emails
    • Check DNS records
    • Remove unused domains
    • Get available domains for registration
    • Get domains purchase payment link
    • Get domain connection requests
    • Remove domain connection requests
    • Connect Domain with Zapmail (New)
    • Add Google Client ID to Domain
    • Get availability of multiple domain names.
  • dns
    • Get dns records
    • Add dns records
    • Update dns records
    • Delete dns records
  1. workspaces

Retrieve all workspaces

GET
/v2/workspaces
Use this endpoint to retrieve a list of all workspaces associated with the authenticated user. You can filter the results using pagination parameters and an optional search keyword.

Request

Query Params

Header Params

Request Code 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/v2/workspaces?page=1,2,3...&limit=10, 50, 100&contains=tryzapmail.com' \
--header 'x-auth-zapmail;' \
--header 'x-workspace-key;' \
--header 'x-service-provider;'

Responses

🟢200Success
application/json
Default sort order: ascending by creation time (oldest first, newest last).
Body

Example
{
    "status": 200,
    "message": "Workspaces fetched successfully",
    "data": [
        {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "name": "John's Workspace",
            "domainCount": "15",
            "mailboxCount": "8",
            "billingDetails": {
                "id": "987f6543-b21a-43c8-9876-543210fedcba",
                "userId": "123e4567-e89b-12d3-a456-426614174000",
                "firstName": "John",
                "lastName": "Doe",
                "workspaceId": "123e4567-e89b-12d3-a456-426614174000",
                "company": "TechCorp",
                "addressLineOne": "123 Main Street",
                "addressLineTwo": "Suite 400",
                "addressLineThree": null,
                "city": "Metropolis",
                "state": "California",
                "country": "US",
                "postalCode": "90210",
                "phoneCc": "1",
                "phone": "5551234567",
                "languagePreference": "en"
            }
        },
        {
            "id": "789d1234-e56b-78c9-a123-098765432112",
            "name": "Jane's Workspace",
            "domainCount": "25",
            "mailboxCount": "12",
            "billingDetails": {
                "id": "54321fed-cba9-8765-4321-0fedcba98765",
                "userId": "789d1234-e56b-78c9-a123-098765432112",
                "firstName": "Jane",
                "lastName": "Smith",
                "workspaceId": "789d1234-e56b-78c9-a123-098765432112",
                "company": "Innovatech",
                "addressLineOne": "456 Elm Street",
                "addressLineTwo": "Apt 101",
                "addressLineThree": null,
                "city": "Gotham",
                "state": "New York",
                "country": "US",
                "postalCode": "10001",
                "phoneCc": "1",
                "phone": "5559876543",
                "languagePreference": "en"
            }
        }
    ]
}
Modified at 2025-10-14 09:20:16
Previous
Retrieve User Details
Next
Create new workspace
Built with