# Bottled API

**Canonical:** https://apis.io/apis/bottled-email/bottled-email-api/  
**Provider:** Bottled — https://apis.io/providers/bottled-email/  
**Documentation:** https://bottled.email/docs/api

Bottled API is one of 2 APIs that [Bottled](https://apis.io/providers/bottled-email/) 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.

Bottled API as documented publicly: 8 operations. Contract generated from the documentation by API Evangelist (2026-11-03); not the provider's own document.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/send` | POST /api/v1/send |
| GET | `/domains` | List all domains |
| GET | `/domains/{name}` | Domain details |
| POST | `/domains/{name}` | Verify domain DNS |
| GET | `/emails` | List email addresses |
| POST | `/emails` | Create email address |
| POST | `/send` | Send an email |
| GET | `/status` | Check your plan, current usage, and remaining quota. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/bottled-email/openapi/_ae-authored/bottled-email-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/bottled-email/json-schema/bottled-email-post-send-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/bottled-email/json-schema/bottled-email-post-api-v1-send-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/bottled-email/json-schema/bottled-email-post-api-v1-send-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/bottled-email/json-schema/bottled-email-get-emails-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/bottled-email/json-schema/bottled-email-get-domains-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/bottled-email/json-schema/bottled-email-post-emails-response-schema.json

## Other Bottled APIs (1)

- [Bottled Email API](https://apis.io/apis/bottled-email/bottled-email-api-2/)

---

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