Certified Mail API

This page is for software developers. To send a letter yourself, open the sending form.

Use the API to quote, draft and track US domestic Certified Mail, with or without an electronic Return Receipt. Send a PDF or typed text. We print and mail the letter after payment and screening.

Get a quote

No API key is needed for quotes. This example returns an itemized one-page quote in US cents before any applicable sales tax.

curl https://certifiedmailsender.com/v1/quotes \
  -H 'Content-Type: application/json' \
  --data '{"service":"certified","pages":1}'

Create a test draft

Sign in to your account and create a test API key. Set CMS_TEST_KEY to that key. Send your key as Authorization: Bearer <key>. Test letters never mail.

Set CMS_IDEMPOTENCY_KEY to a new UUID for each new letter. When retrying a request, reuse its key and body.

curl https://certifiedmailsender.com/v1/letters \
  -H "Authorization: Bearer $CMS_TEST_KEY" \
  -H "Idempotency-Key: $CMS_IDEMPOTENCY_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @- <<'JSON'
{
  "service": "certified",
  "to": {
    "name": "Jordan Lee",
    "line1": "500 Market St",
    "line2": "Suite 200",
    "city": "Philadelphia",
    "state": "PA",
    "zip": "19106"
  },
  "from": {
    "name": "Sam Ortiz",
    "line1": "12 Oak Ave",
    "city": "Columbus",
    "state": "OH",
    "zip": "43215"
  },
  "text": "Dear Jordan,\n\nThis is a test letter."
}
JSON

Approval and payment

For a regular draft, share its private approval_url with the person sending the letter. They review the letter, addresses and price, then approve and pay. A trusted auto-send key pays from prepaid balance after the address check, without per-letter approval. Screening still runs before printing.

API and MCP reference

Read the full OpenAPI specification for request and response fields. Connect an assistant to https://certifiedmailsender.com/mcp or see the assistant setup guide.