API Documentation

Use our REST API to create and manage temporary email accounts programmatically.

API access requires a Developer plan ($4.99/month). Upgrade now

https://tmpbx.site

Most endpoints require a token parameter. Get your token when creating an account.

GET /api/emails?token=YOUR_ACCOUNT_TOKEN

1. Create an account:

curl -X POST https://tmpbx.site/api/accounts \
  -H "Content-Type: application/json" \
  -d '{"domain": "milonfub.xyz"}'

2. Check inbox:

curl "https://tmpbx.site/api/emails?token=YOUR_TOKEN"

3. Read email:

curl "https://tmpbx.site/api/emails?token=YOUR_TOKEN&id=EMAIL_ID"

Endpoints

GET/api/accounts?action=domains

Get available email domains

Response:

{ "domains": ["milonfub.xyz", "kennedyqueen.com"] }

POST/api/accounts

Create a new temporary email account

Request Body:

{ "username": "myname", "domain": "milonfub.xyz", "password": "optional" }

Response:

{ "account": { "id": "...", "email": "myname@milonfub.xyz", "token": "...", "password": "..." } }

POST/api/accounts

Request Body:

{ "action": "login", "email": "user@milonfub.xyz", "password": "pass123" }

Response:

{ "account": { "id": "...", "email": "...", "token": "..." } }

GET/api/accounts?token=YOUR_TOKENAuth Required

Get account details

Response:

{ "account": { "id": "...", "email": "...", "username": "...", "domain": "..." } }

GET/api/emails?token=YOUR_TOKENAuth Required

Get all emails for an account

Response:

{ "emails": [{ "id": "...", "from_address": "...", "subject": "...", "body": "..." }] }

GET/api/emails?token=YOUR_TOKEN&id=EMAIL_IDAuth Required

Get a specific email

Response:

{ "email": { "id": "...", "from_address": "...", "subject": "...", "body": "...", "html_body": "..." } }

DELETE/api/accounts?token=YOUR_TOKENAuth Required

Delete account and all emails

Response:

{ "message": "Account deleted" }

DELETE/api/emails?token=YOUR_TOKEN&id=EMAIL_IDAuth Required

Delete a specific email

Response:

{ "message": "Email deleted" }