Concertix Mail API
Premium temp-mail mailboxes over plain HTTPS. Every route except this page needs the X-API-Key header.
| Method | Route | What it does |
|---|---|---|
| GET | /v1/health | Session valid? Domain count. |
| GET | /v1/domains | Premium domains available right now. |
| GET | /v1/mailboxes | List mailboxes on the account. |
| POST | /v1/mailboxes | Create one. Body {"email"} or {"local","domain"?} (random premium domain when omitted). |
| DELETE | /v1/mailboxes/{email} | Delete a mailbox. |
| GET | /v1/mailboxes/{email}/messages | Inbox summaries. ?page=1&limit=20 |
| GET | /v1/mailboxes/{email}/wait | Long-poll up to 55 s for the first mail newer than ?since= (default: now). 204 on timeout. Loop it. |
| GET | /v1/messages/{id} | Full message: text, html, attachments, links[]. |
| GET | /v1/messages/{id}/attachments/{index} | Download an attachment (the ticket PDF). |
| PUT | /v1/session | Admin only. Body {"sid"} refreshes the premium session. |
Errors: 401 unauthorized · 404 not_found · 409 exists · 400 upstream_error (message from temp-mail) · 503 session_expired · 502 upstream_blocked.
Example: curl -H "X-API-Key: <key>" https://mail.concertix.io/v1/health