API Overview

The MailOven REST API lets you query, search, and delete emails programmatically. It's designed for test automation — poll for expected emails, assert on their content, and clean up after each test run.

Base URL

https://mailoven.com/api/v1

Authentication

All endpoints require a Bearer token in the Authorization header:

Authorization: Bearer mo_your_api_key

See Authentication for how to create and manage API keys.

Endpoints

Method	Path	Description
GET	/api/v1/emails	List and search emails
GET	/api/v1/emails/:id	Get a single email
DELETE	/api/v1/emails/:id	Delete a single email
DELETE	/api/v1/inbox	Clear an entire inbox

Response format

All responses are JSON. Successful responses return the data directly. Errors return an object with an error field:

{ "error": "Email not found" }

Rate limits

API requests are rate-limited to 50,000 requests per 24 hours per organization. See Rate Limits for details.