API Reference

Complete REST API documentation for Tratto Email. All endpoints require authentication with an API key.

Base URL

https://api.tratto.email/v1/

Authentication

Include your API key as a bearer token:

Authorization: Bearer tratto_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Interactive API Reference

For detailed endpoint documentation, request/response examples, and a live API explorer, visit the Interactive API Reference.

The interactive reference includes:

Full endpoint documentation: Method, path, parameters, request/response schemas
Authentication requirements: Which endpoints need API keys
Error codes: All possible error responses
Try it panel: Make real API calls from the docs (your API key stays in your browser)
Code examples: cURL, JavaScript, Python samples

The reference covers the public, stable API: the routes an API key can call. A few routes exist only to serve the dashboard. They are left out of the reference on purpose, answer 403 FORBIDDEN to an API key, and can change without notice. Their absence is deliberate: build on the documented endpoints.

Quick Links

Send Email: POST /emails
Email Status: GET /emails/{id}
Domains: Domain verification
Templates: Email templates
Contacts: Contact management
Webhooks: Event subscriptions
Analytics: Metrics and insights

Rate Limiting

Requests are rate-limited to 100 per second per API key and 500 per minute per client IP. See Rate Limits for details.

Error Handling

All errors return JSON with code and message:

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing or invalid API key.",
    "docs": "https://docs.tratto.email/en/docs/error-codes"
  }
}

See Error Codes for complete reference.

👉 Start with the Interactive API Reference to explore all endpoints.