Sign in

v50

latestOpenAPI 3.0.3AGPLv3raw.githubusercontent.com2026-04-1028178439.6 KB
US

Verify Address

The address verify API validates, corrects, and standardizes individual addresses based on USPS's Coding Accuracy Support System (CASS).

The address verify API accepts the 3 combination of inputs:

  • Free-form address submitted as a single string in query
    • Example: "123 Main St, Springfield, CO 81073-1119"
  • Only free-form and zip code address components submitted as separate parameters:
    • query for the first address line
    • zip_code for the ZIP code
    • Example:
      • query: "123 Main St, Springfield CO"
      • zip_code: "81073-1119"
  • Only free-form, city and state address components submitted as separate parameters:
    • query for the first address line
    • city for the city
    • state for the state
    • Example:
      • query: "123 Main St"
      • city: "Springfield"
      • state: "CO"
post/verify/addresses

Query parameters

api_keystring

API Key

Your unique identifier that allows access to our APIs.

Begins ak_. Available from your dashboard

tagsstring

** Tags ** A comma separated list of tags to query over.

Useful if you want to specify the circumstances in which the request was made.

If multiple tags are specified, the response will only comprise of requests for which all the tags are satisfied - i.e. searching "foo,bar" will only query requests which tagged both "foo" and "bar".

contextstring

Identify the country of the address to verify. Defaults to United States (USA)

Request body

querystring required

Address input to verify.

If submitting a freeform address verification query, enter the full address. E.g. query=123 Main St, Springfield, CO, 81073

Otherwise, query can be accompanied with the following address components:

  • zip_code
  • city and state

If zip_code or city and state or supplied, please omit this information from query by using it purely for the first address line. E.g. query=123 Main St

zip_codestring

Specify the zip code of an address. The following formats are accepted: 81073-1119, 810731119, 81073.

citystring

City of an address. For the US, this should be the city name.

statestring

State of an address. For the US, this should be in the 2 letter state abbreviation format.

Example request

{
  "query": "123 Main St, Springfield, CO 81073",
  "zip_code": "81073-1119",
  "city": "Springfield",
  "state": "CO"
}

Response

Success

code2000 required
message'Success' required

Example response

{
  "result": {
    "match": {
      "address1": "101 Cauther Ln",
      "carrier_route": "C019",
      "check_digit": "4",
      "country_code": "US",
      "county": "Otero",
      "day_light_savings": true,
      "delivery_point": "10",
      "dpv_footnotes": "AABB",
      "elot": "0133A",
      "fips_county_code": "035",
      "rdi": "Y",
      "state": "NM",
      "time_zone": "MST",
      "zip_code": "88310-5631",
      "country_iso_2": "US"
    },
    "match_information": "Single Response - The delivery address was found in the National Database and no further information was required.",
    "address_line_one": "123 Main St",
    "city": "Springfield",
    "state": "CO",
    "zip_code": "81073-1119",
    "country_iso_2": "US"
  }
}