List mailboxes
Returns summaries of the mailboxes the caller can read, newest first, filterable by namespace (`namespaceId`) and creation time (`after`, `before`).
GET
Returns summaries of the mailboxes the caller can read, newest first, filterable by namespace (namespaceId) and creation time (after, before). Pass nextCursor back as cursor for the next page; it is null on the last page. Read a mailbox's endpoints and metadata with GET /v1/mailboxes/{id}.
apiKeyheader
x-api-key<token>limit?|nullcursor?stringafter?stringbefore?stringnamespaceId?stringMatch
^ns_[0-9a-hjkmnp-tv-z]{16,24}$MailboxPage
application/json- response
items*array<>nextCursor*string|nullimport { createClient } from "samva";
const samva = createClient({ apiKey: process.env.SAMVA_API_KEY! });
const result = await samva.mailboxes.list({});Example Response
{
"items": [
{
"id": "string",
"kind": "personal",
"owner": "string",
"namespaceId": "string",
"slug": "string",
"name": "string",
"status": "active",
"primaryAddress": "string",
"sendingStatus": "pending",
"createdAt": "string"
}
],
"nextCursor": "string"
}