OpenAPI Spec

The full OpenAPI 3.0 specification is available for download and import into your favorite API client.

Interactive Documentation

Browse the interactive API reference powered by Scalar:

Open API Reference →

Download Spec

curl -O https://api.mail.td/api/docs/openapi.yaml

Or download directly: openapi.yaml

Official SDKs

We provide official SDKs for popular languages — see the SDKs page for installation and usage.

Language	Package	Repository
Node.js / TypeScript	npm install mailtd	mailtd/mailtd-node
Python	pip install mailtd	mailtd/mailtd-python
Go	go get github.com/mailtd/mailtd-go	mailtd/mailtd-go

Import into API Clients

Postman

1. Open Postman → Import → Link
2. Paste: https://api.mail.td/api/docs/openapi.yaml
3. Click Import

Insomnia

1. Open Insomnia → Import/Export → Import Data
2. Choose From URL
3. Paste: https://api.mail.td/api/docs/openapi.yaml

Bruno

1. Open Bruno → Collection → Import
2. Select OpenAPI → paste the URL or downloaded file

Generate Custom Client

If you need a language not covered by the official SDKs, use OpenAPI Generator:

# Install
npm install @openapitools/openapi-generator-cli -g

# Generate (example: Ruby)
openapi-generator-cli generate \
  -i https://api.mail.td/api/docs/openapi.yaml \
  -g ruby \
  -o ./mailtd-ruby