Developer Docs

Developer API Reference

Integrate TempNova's underlying email engine into your own QA tests, verification systems, or automated accounts.

API Endpoint

https://api.temp-nova.com

Authentication

Bearer JWT (JSON Web Tokens)

Rate Limiting

8 requests/sec per client IP

Available Endpoints

GET/domains

List active temporary domains

curl -X GET "https://api.temp-nova.com/domains" \
  -H "accept: application/json"

POST/accounts

Create a new mailbox account

curl -X POST "https://api.temp-nova.com/accounts" \
  -H "Content-Type: application/json" \
  -d '{"address": "user@domain.com", "password": "secure_password"}'

POST/token

Acquire JWT authentication token

curl -X POST "https://api.temp-nova.com/token" \
  -H "Content-Type: application/json" \
  -d '{"address": "user@domain.com", "password": "secure_password"}'

GET/messages

Retrieve message index feed

curl -X GET "https://api.temp-nova.com/messages" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "accept: application/json"

GET/messages/{id}

Retrieve single email details

curl -X GET "https://api.temp-nova.com/messages/MESSAGE_ID" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "accept: application/json"

DELETE/accounts/{id}

Delete and release temporary account

curl -X DELETE "https://api.temp-nova.com/accounts/ACCOUNT_ID" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Auth Workflow

Fetch active domains using GET /domains.
Register address & password using POST /accounts.
Generate auth token using POST /token.
Inject token as Authorization: Bearer <JWT> for message endpoints.

Error Status Codes

400 Bad RequestInvalid formatting

401 UnauthorizedToken missing/expired

409 ConflictAddress taken

422 UnprocessableInactive domain

429 Rate LimitToo many requests