# mails-ai Inbound API

**Canonical:** https://apis.io/apis/mails-ai/mails-ai-inbound-api/  
**Provider:** mails-ai — https://apis.io/providers/mails-ai/  
**Base URL:** https://api.mails.ai

mails-ai Inbound API is one of 19 APIs that [mails-ai](https://apis.io/providers/mails-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Inbound. The published artifact set on APIs.io includes an OpenAPI specification.

Received messages and the test-key inbound simulator.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/messages/received` | List received messages |
| GET | `/v1/messages/received/wait` | Wait for a received message |
| GET | `/v1/messages/received/{id}` | Retrieve a received message |
| GET | `/v1/messages/received/{id}/attachments` | List a received message's attachments |
| GET | `/v1/messages/received/{id}/attachments/{attachment_id}` | Download an attachment |
| POST | `/v1/test/inbound` | Simulate an inbound email (test key) |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/mails-ai/openapi/mails-ai-inbound-api-openapi.yml

## Other mails-ai APIs (12)

- [mails-ai Account API](https://apis.io/apis/mails-ai/mails-ai-account-api/)
- [mails-ai Agents API](https://apis.io/apis/mails-ai/mails-ai-agents-api/)
- [mails-ai API Keys API](https://apis.io/apis/mails-ai/mails-ai-api-keys-api/)
- [mails-ai Billing API](https://apis.io/apis/mails-ai/mails-ai-billing-api/)
- [mails-ai Connected Apps API](https://apis.io/apis/mails-ai/mails-ai-connected-apps-api/)
- [mails-ai Domains API](https://apis.io/apis/mails-ai/mails-ai-domains-api/)
- [mails-ai Drafts API](https://apis.io/apis/mails-ai/mails-ai-drafts-api/)
- [mails-ai Events API](https://apis.io/apis/mails-ai/mails-ai-events-api/)
- [mails-ai Labels API](https://apis.io/apis/mails-ai/mails-ai-labels-api/)
- [mails-ai Logs API](https://apis.io/apis/mails-ai/mails-ai-logs-api/)
- [mails-ai Messages API](https://apis.io/apis/mails-ai/mails-ai-messages-api/)
- [mails-ai Metrics API](https://apis.io/apis/mails-ai/mails-ai-metrics-api/)

## Tags

Inbound

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/mails-ai/mails-ai-inbound-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/mails-ai/.