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

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.