VookMail Developer API

Create temporary inboxes and read messages from your own apps with a simple REST API. Responses are JSON.

Authentication

Send your API key in the Authorization header. Keys are issued by the site owner.

curl https://www.vookmail.com/api/v1/domains \
  -H "Authorization: Bearer vk_your_key"

Endpoints

Base URL: https://www.vookmail.com/api/v1

Method	Path	Description
GET	/domains	List the available domains
POST	/mailboxes	Create a mailbox. Body: username and domain, both optional
GET	/mailboxes/{address}	Mailbox details and expiry
POST	/mailboxes/{address}/extend	Extend the mailbox lifetime
DELETE	/mailboxes/{address}	Close the mailbox and delete its messages
GET	/mailboxes/{address}/messages?after={id}	List messages, with detected codes and links
GET	/mailboxes/{address}/messages/{id}	Read one message: sanitized HTML, text and attachments
DELETE	/mailboxes/{address}/messages/{id}	Delete one message
GET	/mailboxes/{address}/messages/{id}/attachments/{attachment}	Download an attachment

Example

curl -X POST https://www.vookmail.com/api/v1/mailboxes \
  -H "Authorization: Bearer vk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"username":"myapp"}'

{"address":"myapp@example.com","token":"...","expires_at":"2026-10-31T12:00:00+00:00"}

Errors and limits

Errors return an HTTP status with error.code and error.message. Each key has a limit per minute; going over it returns status 429.