Skip to content
USPS address verification · API

Address verification API

Call Pelcro to validate an address from your front-end sign-up flow, or cleanse and enrich addresses server-side. Every check returns a standardized address, a deliverability status and USPS codes.

Trusted by leading publishers worldwide

Already trusted by leading publishers worldwide

How the API works

Try the address verification API

Pick a call. See the request you send and the JSON Pelcro returns, including the standardized address and USPS codes.

  1. 1SendPOST an address to Pelcro from your front-end or your server.
  2. 2ValidatePelcro parses, standardizes and DPV-checks it against USPS data.
  3. 3ReturnYou get back the standardized address, a status, and ZIP+4 and Carrier Route.
  4. 4HandleAccept the match, apply a suggested fix, or surface the error to the user.

POST /v1/addresses/verify

{ "line1": "123 e main apt4",
  "city": "springfield", "state": "il" }

200 OK

{ "status": "deliverable",
  "line1": "123 E MAIN ST APT 4",
  "zip4": "62701-2234", "dpv": true }

Illustrative. Example request and response, not live API output.

Who it's for

Who it's for

  • Developers adding address validation to a sign-up or checkout flow
  • Engineering teams cleansing addresses across back-end workflows
  • Product teams that want fewer bad addresses at the source

Features

What it does

Front-end and server-side
Validate at the point of entry, or cleanse and enrich addresses server-side across your workflows.
One clear response
Every check returns a standardized address, a suggested fix for a near-match, or an error with detail.
Standardized, not just pass/fail
Responses are parsed and standardized to USPS Publication 28, so you can store the corrected address.
Deliverability and enrichment
Responses carry DPV status plus ZIP+4, Delivery Point, Carrier Route and eLOT codes.
Built into the Pelcro SDK
Validate from the Pelcro JS SDK on your sign-up form, or call the API directly from your server.
CASS-certified underneath
The same CASS-certified engine powers the API, so results qualify your mail for automation discounts.

Last updated

FAQ

Frequently asked questions

What does an address verification API do?
An address verification API checks an address against USPS data and returns a result your code can act on: a standardized, deliverable address, a suggested fix for a near-match, or an error. Pelcro's API also appends ZIP+4 and Carrier Route codes. See USPS address verification
Can I validate addresses in real time at sign-up?
Yes. Call the API from your front-end or the Pelcro JS SDK as a subscriber types, so a bad address is caught and corrected before the account is created.
Does the API work server-side for batch cleansing?
Yes. Call it server-side to cleanse and enrich addresses across your workflows, for example before an export to a mail house.
What does the API return for a bad address?
For a near-match it returns a suggested standardized fix; for an address it cannot validate it returns an error with troubleshooting detail, so you can prompt the user or flag the record.
Does the API standardize addresses to USPS format?
Yes. Responses are standardized to USPS Publication 28, so you store a consistent, corrected address rather than the raw input.
Is the address verification API CASS certified?
Yes. The API runs on the same CASS-certified engine as the rest of Pelcro's address verification, so addresses it validates qualify your mail for USPS automation discounts. See CASS certified verification

Get started

Add address verification to your flow

Validate and enrich addresses from your front-end or server-side with one API.

By submitting your email, you agree to opt in to marketing emails.

Contact sales

Talk to our team

Leave your work email and pick a time that suits you. We'll follow up either way.

By submitting your email, you agree to opt in to marketing emails.

See Pelcro in action

Book a demo