---
title: "Verify Address"
method: POST
path: "/verify/addresses"
tags: ["Address Search"]
---

# Verify Address

`POST /verify/addresses`

## Request

- Base URL: `https://api.addresszen.com/v1`
- URL: `https://api.addresszen.com/v1/verify/addresses`
- Auth: HTTP bearer

Verifies an address against the USPS Coding Accuracy Support System (CASS) and returns it standardized and corrected.

Submit the whole address in `query`, or the first address line in `query` with either `zip_code`, or `city` and `state`. A freeform `query` is parsed into those components before the search runs.

A match returns the standardized address lines, city, state and ZIP+4, scored by `fit` and `confidence`. It also carries the CASS record behind the match: delivery point, DPV flags, carrier route, eLOT, county, congressional district, RDI, time zone and coordinates. No match returns `200` with a `count` of `0`, a `null` `match` and empty address fields.

Only a match draws on your balance. A key without address verification enabled returns `401`. A verification still running after 9.5 seconds aborts with `429`.

## Countries

Verify defaults to the United States, where it is CASS certified. Pass `context` with an ISO 3166-1 alpha-3 country code to verify an address elsewhere, e.g. `context=GBR` or `context=FRA`. The address datasets your key is licensed for decide which countries it can verify.

Outside the United States there is no CASS record to return, so `match` carries the standardized address from that country's dataset instead. The top-level fields (`address_line_one`, `city`, `state`, `zip_code`, `country_iso_2`) are populated for every country, along with `confidence` and `fit`.

## Query parameters

- `api_key` string
- `tags` string
- `context` string

## Request body

- object
  - `query` string, 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 you supply `zip_code`, or `city` and `state`, omit that information from `query` and use it for the first address line only. E.g. `query=123 Main St`
  - `zip_code` string: Specify the ZIP code of an address. The following formats are accepted: `81073-1119`, `810731119`, `81073`.
  - `city` string: City of an address.
  - `state` string: State of an address. For the US, use the 2 letter state abbreviation.

## Response `200`

Success

- VerifyResponse
  - `code` 2000, required
  - `message` 'Success', required
  - `result` union, required
    - UsaVerifyMatch
      - `query` string, required: Submitted query
      - `query_city` string, required: Submitted city
      - `query_state` string, required: Submitted state
      - `query_zip_code` string, required: Submitted zip_code
      - `match` UsaCassVerifiedAddress, required: Address retrieved using CASS compliant address verification process
        - `address1` string, required: Primary delivery address
        - `address2` string, required: Secondary address information
        - `address3` string, required: Additional secondary address information
        - `area_code` string, required: Area code. Also known as Numbering Plan Area (NPA) https://en.wikipedia.org/wiki/List_of_North_American_Numbering_Plan_area_codes
        - `carrier_route` string, required: Data required to perform a Carrier Route sort
        - `check_digit` string, required: Character following the 5 or 9 digit ZIP Code. Part of the 11-digit barcode
        - `city` string, required: City name
        - `city_abbreviation` string, required: City Abbreviation. Empty string if not present
        - `congressional_district` string, required: Identifies the Congressional District. Empty string if not present
        - `country_code` string, required: ISO3166 country code. Empty string if not present
        - `county` string, required: Name of the county
        - `day_light_savings` boolean, required: Daylight saving time indicator
        - `delivery_point` string, required: Last 2 digits of the primary street address number or Post Office box
        - `dpv` 'Y' | 'S' | 'D' | 'N' | '', required: Delivery Point Validation (DPV) Confirmation code. Possible values: - 'Y' Primary and secondary address information was validated - 'S' Extraneous or incorrect secondary address present - 'D' Secondary address information missing - 'N' Primary and secondary address information was not validated - '' Address was not submitted to DPV lookup. Address was not ZIP+4 matched.
        - `dpv_cmra` 'Y' | 'N' | '', required: Delivery Point Validation (DPV) CMRA code. Indicates if the address is linked to a Commercial Mail Receiving Agency (CMRA), such as the UPS Store or Mailboxes Etc., where USPS mail can be sent or received. Possible values: - 'Y' Address is associated with a CMRA - 'N' Address is not associated with a CMRA - '' Empty string if address is not DPV validated.
        - `dpv_footnotes` string, required: Delivery Point Validation (DPV) Footnotes. Empty string if not present Possible values: - 'AA' ZIP+4 matched. - 'A1' ZIP+4 did not match. - 'BB' Primary and secondary address information was DPV validated. - 'CC' Primary address information was DPV validated. Input secondary address information dropped. - 'F1' Military address. - 'G1' General delivery address. - 'N1' Primary address information was DPV validated. Highrise address with missing secondary address information. - 'M1' Primary number missing from address. - 'M3' Primary number invalid. - 'P1' Box number missing. - 'P3' Box number invalid. - 'RR' Validated CMRA address with PMB information. - 'R1' Validated CMRA address without PMB information. - 'U1' Unique 5-digit ZIP code.
        - `dpv_no_stat` 'Y' | 'N' | '', required: Delivery Point Validation (DPV) NoStat code. Indicates whether the address is a vacant property, it receives mail as a part of a drop, or it does not have an established delivery yet. Possible values: - 'Y' Confirmed - 'N' Not confirmed - '' Empty string if address is not DPV validated.
        - `dpv_vacant` 'Y' | 'N' | '', required: Delivery Point Validation (DPV) Vacant code. USPS records indicate that although this may be a valid address, the residence or business is vacant. Possible values: - 'Y' Confirmed vacant - 'N' Not confirmed vacant - '' Empty string if address is not DPV validated.
        - `elot` string, required: Enhanced Line of Travel. For arranging records in the order that a route is served by a carrier. eLOT sequencing, when combined with Carrier Route codes, may allow Enhanced Carrier Route (ECR) discounts to be claimed.
        - `finance_number` string, required: Internal accounting number used by the USPS® when Post Offices or ZIP Codes are discontinued and reassigned. The finance number reflects the geographic grouping of ZIP + 4 areas in which these changes can be made. Empty string if not present
        - `fips_county_code` string, required: Federal Information Processing Standard code for a county. Empty string if not present
        - `firm` string, required: Company name in a business address
        - `footnotes` string, required: Letter codes returned by ZIP+4 encoding. Empty string if not present
        - `geo_coded` boolean, required: Indicates whether the address was geo-coded
        - `lacs_indicator` 'L' | '', required: Indicates whether a record may benefit from LACS processing. Possible values: - 'L' Yes - '' No
        - `lacs_link_footnote` 'A' | '00' | '09' | '14' | '92' | '', required: LACSLink Footnote. Return Code returned by the LACSLink process when an accurate address match could not be made. These codes help identify the type of move and the type of deficiency in the record which prevents a match. Possible values: - 'A' Address matched - '00' No match - '09' The input record matched to a record in the master file, but the old address is a highrise default - '14' The input record matched to a record in the master file. The new address could not be converted to a deliverable address - '92' LACSLink Record: Secondary Number Dropped from Input Address - The input record matched to a master file record, but the input address had a secondary number and the master file record did not. The record is a ZIP + 4 street level or high-rise match - '' Address not submitted to LACSLink lookup
        - `lacs_link_indicator` 'Y' | 'S' | 'N' | '', required: LACSLink Indicator. Indicates whether the input address matched a record in the LACSLink database. Possible values: - 'Y' Matched a record in the master file - 'S' The input record matched a master file record, but the input address included a secondary number that the master file record lacked - 'N' No match - '' Empty string if not present
        - `latitude` string, required: Latitude of the encoded address. Empty string if not present
        - `longitude` string, required: Longitude of the encoded address. Empty string if not present
        - `parsed_pmb_designator` string, required: Information if a Private Mail Box (PMB) is found in an address. Empty string if not present
        - `parsed_pmb_number` string, required: Information if a Private Mail Box (PMB) is found in an address. Empty string if not present
        - `parsed_post_directional` string, required: Notation following the street name indicating street direction. Empty string if not present
        - `parsed_pre_directional` string, required: Notation preceding the street name indicating street direction. Empty string if not present
        - `parsed_primary_number` string, required: Number preceding the street name. Empty string if not present
        - `parsed_street_name` string, required: Street name. Empty string if not present
        - `parsed_suffix` string, required: Part of the delivery address line following the street name. Empty string if not present
        - `parsed_unit_designator` string, required: Identification of the secondary address unit. Empty string if not present
        - `parsed_unit_number` string, required: Apartment or suite number. Empty string if not present
        - `rdi` string, required: Residential Delivery Indicator (RDI). Indicates whether USPS classifies the delivery point as residential. Empty string if not present
        - `record_type` 'C' | 'F' | 'G' | 'H' | 'M' | 'P' | 'R' | 'S' | 'U' | '', required: Type of address record. Possible values: - 'C' Multi-Carrier - 'F' Firm - 'G' General Delivery - 'H' High-rise or Apartment Building - 'M' Military - 'P' PO Box - 'R' Route (Rural Route/Highway Contract) - 'S' Street - 'U' Unique 5-Digit
        - `state` string, required: Standard two-letter state abbreviation
        - `suite_link_footnote` '' | '00' | 'A', required: Results of the SuiteLink lookup. Possible values: ' ' (Space), '00' (Double Zero), 'A' (A). Empty string if not present
        - `time_zone` string, required: Time zone. Empty string if not present
        - `urbanization` string, required: Urban name required in the address of all mail being delivered to Puerto Rico. Empty string if not present
        - `zip_code` string, required: 5-digit ZIP Code and the four additional digits
      - `count` number, required: The number of addresses we matched to the input. We return the closest match by default.
      - `fit` number, required: A score represented as number between 1 and 0. Fit compares the address elements present in your query against the matching address elements. It does not incorporate elements you have not presented in the score. A partial address (e.g. 123 Main St) will have a fit of 1 even though it is missing city and zip code. Its confidence score will be less than 1 however because it is missing some crucial elements.
      - `confidence` number, required: A confidence score represented as number between 1 and 0. 1 indicates a full match. 0 indicates no complete matching elements.
      - `match_information` string, required: Additional information about the match. This information is for human consumption and may not be present in all responses.
      - `address_line_one` string, required: Primary delivery address
      - `address_line_two` string, required: Secondary address information
      - `city` string, required: City name
      - `state` string, required: State name
      - `zip_code` string, required: Zip code
      - `country_iso_2` string, required: 2 letter ISO country code
    - UsaVerifyNoMatch
      - `query` string, required: Originally submitted query
      - `query_city` string, required: Originally submitted city
      - `query_state` string, required: Originally submitted state
      - `query_zip_code` string, required: Originally submitted zip_code
      - `match` null, nullable, required: Nearest matching address
      - `count` 0, required
      - `fit` 0, float, required
      - `confidence` 0, float, required
      - `address_line_one` '', required: Empty if no match
      - `address_line_two` '', required: Empty if no match
      - `city` '', required: Empty if no match
      - `state` '', required: Empty if no match
      - `zip_code` '', required: Empty if no match
      - `country_iso_2` '', required: Empty if no match

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/addresszen/apis/api-reference.md) · [All operations](https://skmtc.dev/addresszen/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/addresszen/apis/api-reference/revisions/cac119db15c0?raw)