API documentation

Use the REST API to create temporary addresses and read their messages from your own software. Log in and copy your API key from the dashboard.

Authentication

Send your key in the X-API-Key header (or Authorization: Bearer KEY). Limit: 60 requests / minute.

curl -H "X-API-Key: YOUR_API_KEY" https://tempinboxer.com/api/v1/domains

Log in → Dashboard → Your API key

Endpoints

List active domains.

{"ok":true,"domains":["example.com","example.net"]}

Create (reserve) an address. Both parameters are optional – a random name and the default domain are used when omitted.

{"ok":true,"address":"john@example.com"}

List the latest messages (max 100).

{"ok":true,"address":"john@example.com","count":1,"messages":[
  {"id":42,"from_name":"GitHub","from_email":"noreply@github.com","subject":"Verify your email",
   "preview":"Your code is 123456","attachments":0,"read":false,"received_at":"2026-01-01T12:00:00Z"}
]}

Read a full message (text, html and attachment links).

Delete one message.

Delete all messages of an address.

Example (JavaScript)

const KEY = "YOUR_API_KEY";
const api = (p) => fetch("https://tempinboxer.com/api/v1" + p, { headers: { "X-API-Key": KEY } }).then(r => r.json());

const { address } = await api("/mailbox");
// ...use the address on a sign-up form, then:
const { messages } = await api("/inbox?address=" + encodeURIComponent(address));