API for developers & QA teams

Rent disposable details programmatically — test your signup and OTP flows against real Australian numbers and inboxes. Same prices and rules as the website ($2.00 per email, $4.00 per number, from your prepaid balance).

Running real volume? We do volume deals for teams — tell us your numbers and we'll come back with pricing.

Authentication

Create a key in account settings, then send it as a Bearer token. Limit: 120 requests/minute per key.

Authorization: Bearer mnd_your_key_here

Endpoints

GET /api/v1/account

Your balance and current prices.

curl -H "Authorization: Bearer $KEY" https://mynewdetails.com.au/api/v1/account

POST /api/v1/emails

Rent a disposable inbox for a site. Charges your balance; returns the session. 

curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"site": "example.com"}' https://mynewdetails.com.au/api/v1/emails

POST /api/v1/phones

Rent an Australian number for a site — guaranteed never used on that site before. 

curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"site": "example.com"}' https://mynewdetails.com.au/api/v1/phones

GET /api/v1/sessions/{id}

Poll a rental for messages. latest_otp is the newest OTP-shaped code. 

{
  "id": 42, "kind": "email", "address": "x1y2z3@inbox.mynewdetails.com.au",
  "site": "example.com", "status": "received", "receiving": true,
  "expires_at": "2026-07-19T10:00:00Z", "latest_otp": "482913",
  "messages": [{"id": 7, "channel": "email", "sender": "no-reply@example.com",
                "subject": "Your code", "body": "Your code is 482913",
                "otp": "482913", "received_at": "2026-07-12T10:01:00Z"}]
}

Errors

JSON with an error code: unauthorized (401), insufficient_balance (402), prohibited (403 — the attempt is recorded; government/bank services are never served), bad_site (400), velocity_limited / rate_limited (429), no_capacity / paused (503).

MCP server (AI agents)

Building with Claude or another MCP-capable agent framework? We publish a zero-dependency MCP server that wraps this API — your agent gets rent_email, rent_phone, get_session and get_account as tools (ideal for automated QA of signup flows). Download mcp_server.py (zero dependencies, plain Python 3.10+), then: 

{"mcpServers": {"mynewdetails": {
  "command": "python", "args": ["mcp_server.py"],
  "env": {"MND_API_KEY": "mnd_your_key_here"}}}}

Rules worth knowing

  1. The same acceptable-use rules as the website apply — prohibited-site attempts suspend the account, API or not.
  2. Numbers are exclusive while rented and never re-used for the same site.
  3. Inboxes receive for 7 days, numbers for 24 hours; poll the session for messages.
  4. Need volume pricing? Use the contact form below — it goes straight to our team.

Contact us

Volume pricing, partnership, or an integration question — send it here and we'll reply by email.