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.

1

Create a verification

Enter a recipient and address from the dashboard or API.

2

Mail the code

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

3

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.

Sandbox first

Test the request, postcard preview, and code-confirmation flow before sending live mail.

Human approval

Live mail and billing controls stay visible in the dashboard.

Developer ready

Use OpenAPI, webhooks, and simple status endpoints when you want to automate the flow.