#Mittis developer docs

Mittis is a carrier-direct messaging and voice platform. One JSON REST API lets you buy phone numbers, send and receive texts, route and place calls, send email from your own domain, register for 10DLC, and receive signed webhooks for everything that happens.

Base URL: https://api.mittis.ai
Console: app.mittis.ai for API keys, numbers, registration and billing
Format: JSON in, JSON out. Amounts are integer cents. Phone numbers are E.164 (+14155550199).
Spec: OpenAPI 3.1, the source of truth for the API reference and the event catalog in these docs.

#What you can build

Area	What the API gives you
Messaging	Send SMS and MMS, read message history and conversations, receive inbound texts and delivery status webhooks.
Numbers and calling	Search and buy local or toll-free numbers, route inbound calls, voicemail, recordings, browser softphones.
10DLC	Register a brand and campaign, attach numbers, track approval.
Email	Verify a sending domain, send transactional email, follow its lifecycle events and suppressions.
Webhooks and events	Signed, at-least-once delivery with retries, plus a durable polling feed of the same events.
Agencies	Manage sub-accounts with one agency key and the `Mittis-Subaccount` header.

#Where to start

Quickstart: an API key and your first text in a few minutes.
Test mode: build the whole integration without touching a carrier.
Webhooks: verify signatures and write a receiver that holds up.
API reference: every endpoint, schema and event, with a request runner.

#Conventions

Authenticate with Authorization: Bearer <key>. See Authentication.
Every error uses one envelope. Branch on error.code. See Errors and pagination.
List endpoints return { "data": [...], "hasMore": false, "nextCursor": null }.
POST /v1/messages, POST /v1/emails and POST /v1/ports accept an Idempotency-Key header so retries are safe.