Postcard OTP API

Verify real addresses by mail

address.bot sends a postcard with a QR link and printed code, so businesses, residents, and properties can prove they can receive mail at the address on file.

Postcard with QRSix-digit confirmation codeStatus updates when verified

Request

API

Proof

Mail

Result

Webhook

How it works

A physical check with a clean API shape.

Create a verification

One recipient and one street address. One postcard per address.

Mail the code

Send a postcard with a private QR link and six-digit code.

Confirm reachability

The recipient scans, enters the code, and the address is marked verified.

Product fit

Built for mailed reachability, not address parsing.

Address validation tells you whether a string resembles a postal record. address.bot tells you whether a real mailpiece got there and whether someone could redeem the code.

Business onboarding

Verify that merchants, vendors, or business locations can receive mail at the address they submit.

Residence checks

Confirm mailbox access without forcing users through a full identity verification flow.

Property workflows

Start occupancy, notice, or follow-up workflows with proof that mail reached the site.

Minimal request

{
  "request_type": "address_confirmation",
  "recipient": {
    "name": "Jane Resident",
    "line1": "123 Main St",
    "city": "Austin",
    "region": "TX",
    "postal_code": "78701",
    "country": "US"
  },
  "reference": "jane-main-mailbox"
}

Controls

Simple by default, explicit when it matters.

Waitlist

Postcard verification opens from this list. One email, no account.

Live mail today

Postcards and letters already print and mail through mailbox.bot.

Same check

A QR postcard, a six-digit code, and a status update when someone at the address confirms it.

Start here

Join the waitlist for postcard verification.

We'll email you when the QR postcard and six-digit code flow opens. Live postcards and letters already go out through mailbox.bot.

Join the waitlist mailbox.bot