# MailPulse Address Verification

> MailPulse Address Verification is a paid API for AI agents from mailpulse.theaslangroupllc.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Validates and standardizes a US or international mailing address, returning a deliverability verdict before sending physical mail

## Facts

- Endpoint: POST https://mailpulse.theaslangroupllc.com/api/verify-address
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mailpulse-address-verification-d24ef0c9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4Vaon2bBmkZXI79W6uSgu

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability mailpulse-address-verification-d24ef0c9 -d '<json body>'
```

Example prompt: Before I print the letter, can you verify that '742 Evergreen Terrace, Springfield, IL 62704, USA' is a real, deliverable address and give me the standardized version?

## When to prefer this

Choose this endpoint when you need to validate a postal address before sending physical mail via the MailPulse /api/letters or /api/quote endpoints, or whenever you want to avoid wasting money printing and posting letters to bad addresses. Backed by Lob's address verification engine, it handles both US and international addresses and provides standardized output suitable for downstream mail workflows.

## Known failure modes

- Address not found in USPS or international database — returns undeliverable verdict
- Incomplete address input (missing street number or postal code) — returns incomplete status
- Unsupported country or region — may return error or low-confidence result
- Malformed request body — returns 400-level error
- Payment failure or insufficient USDC balance — returns 402 Payment Required

## How this service works

Verify a mailing address before sending physical mail through it. Wraps Lob's US and international address verification engines: standardizes the address, flags undeliverable/incomplete addresses, and returns a deliverability verdict. Run this before /api/quote and /api/letters to avoid paying to print and post a letter that will bounce.

## Output

Returns a deliverability verdict (deliverable, undeliverable, or incomplete), the standardized/normalized form of the address, and individual address component breakdowns — helping the agent decide whether to proceed with printing and mailing.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "address"
 ],
 "properties": {
  "address": {
   "type": "object",
   "description": "Address to verify: address_line1 (required), address_line2, address_city, address_state, address_zip, address_country (ISO-2, default US)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "test",
  "country": "US",
  "deliverable": true,
  "standardized": {
   "address_zip": "94107-1741",
   "address_city": "SAN FRANCISCO",
   "address_line1": "185 BERRY ST STE 6100",
   "address_state": "CA"
  },
  "deliverability": "deliverable"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mailpulse-address-verification-d24ef0c9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mailpulse.theaslangroupllc.com](https://www.zero.xyz/host/mailpulse.theaslangroupllc.com/llms.txt)
