# Faivelo v1 API

**Canonical:** https://apis.io/apis/faivelo-com/v1-api/  
**Provider:** Faivelo — https://apis.io/providers/faivelo-com/  
**Documentation:** https://faivelo.com/api/v1

Faivelo v1 API is one of 3 APIs that [Faivelo](https://apis.io/providers/faivelo-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Faivelo v1 API as documented publicly: 12 operations. Contract generated from the documentation by API Evangelist (2026-11-07); not the provider's own document.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| GET | `/emails/{id}` | Get a sent email |
| GET | `/mail-host` | Your default mail server name |
| POST | `/mailboxes/{address}/attachments` | Upload a large attachment |
| GET | `/mailboxes/{address}/contacts/avatar` | Get a contact's picture |
| GET | `/mailboxes/{address}/messages/{uid}` | Read a message in full |
| GET | `/mailboxes/{address}/search` | Search messages in a mailbox |
| POST | `/mailboxes/{address}/send` | Send mail |
| POST | `/mailboxes/{address}/send-batch` | Send one email to many recipients |
| GET | `/mailboxes/{address}/send-batch/{id}` | Get a bulk send |
| GET | `/services` | List services |
| GET | `/services/{id}` | Get a service |
| GET | `/usage` | Get usage and limits |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/faivelo-com/openapi/_ae-authored/faivelo-com-v1-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/faivelo-com/json-schema/faivelo-com-post-mailboxes-address-send-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/faivelo-com/json-schema/faivelo-com-post-mailboxes-address-attachments-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/faivelo-com/json-schema/faivelo-com-post-mailboxes-address-attachments-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/faivelo-com/json-schema/faivelo-com-get-emails-id-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/faivelo-com/json-schema/faivelo-com-get-services-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/faivelo-com/json-schema/faivelo-com-get-mail-host-response-schema.json

## Other Faivelo APIs (2)

- [Faivelo core API](https://apis.io/apis/faivelo-com/core-api/)
- [Faivelo transactional API](https://apis.io/apis/faivelo-com/transactional-api/)

---

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