What does registered mean?

The address exists in official government records, the same records 911 systems are built on. It is not USPS deliverability. Nobody can sell you that without a USPS license.

How does autocomplete work?

Pass q= plus a ZIP, or a city and state, from the form. Browser calls rank the caller's home city first. A wrong guess reorders suggestions, it never hides a street.

Can a suggestion invent a house number?

No. A number appears only when it exists in the records. A street without a confirmed number suggests at street grain, number null.

What about apartments and units?

Units pass through and match registry unit rows when they exist. registered reflects the building.

Nothing yet. ?deep=true returns an empty object, reserved.

GET /address/{address}

Address lookup API

Pass an address. Get whether it exists in official government records.

valid

Input parses as a US address. Junk returns valid: false on a 200, never a 404

registered

Address exists in official government records. True or false only where the records cover the area, null when they do not. Not a deliverability claim

number

House number

street

Standardized street line

unit

Unit as given. registered reflects the building when the records have no unit rows

city

City name

district

District code (US county FIPS)

state

State code

postal

5-digit ZIP

latitude

Registry point latitude (null when not registered)

longitude

Registry point longitude (null when not registered)

Pass the address

Freeform, as typed. Street, city, state, ZIP in one string.

Get the verdict

valid, registered, the standardized parts, county, and coordinates.

Autocomplete included

q= plus a ZIP or a city. A house number appears only when it exists.

90 million addresses.

Official government records. Every plan.

90M+
address points: US
official government records: q=
autocomplete included

Pass an address the way a form gave it to you. Back come valid, registered, and the standardized parts: number, street, unit, city, county, state, ZIP, and the registry coordinates. registered means the address exists in official government records, the same records 911 systems are built on. It is not a USPS deliverability claim.

Autocomplete rides the same records. Pass ?q= with a ZIP or a city and state, and ranked suggestions come back. A house number appears only when it exists in the records, never invented. Junk answers valid: false on a 200, never a 404.

RESPONSE

$ curl "https://api.parseapi.com/address/152%20200th%20Avenue%2C%20Ellsworth%20MN" \
  -H "X-API-Key: YOUR_API_KEY"

// 200 · ~16ms US · ~38ms worldwide
{
  "address": "152 200th Avenue, Ellsworth, MN 56129",
  "valid": true,
  "registered": true,
  "number": "152",
  "street": "200th Avenue",
  "unit": null,
  "city": "Ellsworth",
  "district": "27105",
  "district_name": "Nobles",
  "state": "MN",
  "state_name": "Minnesota",
  "postal": "56129",
  "country": "US",
  "country_name": "United States",
  "latitude": 43.506772,
  "longitude": -96.073118
}

Response fields

address: Standardized address line
valid: Input parses as a US address. Junk returns valid: false on a 200, never a 404
registered: Address exists in official government records. True or false only where the records cover the area, null when they do not. Not a deliverability claim
number: House number
street: Standardized street line
unit: Unit as given. registered reflects the building when the records have no unit rows
city: City name
district: District code (US county FIPS)
district_name: District name
state: State code
state_name: State name
postal: 5-digit ZIP
country: ISO2 country code (US for now)
country_name: Country name
latitude: Registry point latitude (null when not registered)
longitude: Registry point longitude (null when not registered)

QUESTIONS

What does registered mean?: The address exists in official government records, the same records 911 systems are built on. It is not USPS deliverability. Nobody can sell you that without a USPS license.
Which addresses are covered?: The United States, about 90 million official address points from state and local 911 authorities. Coverage follows the records ZIP by ZIP. Where they stop, registered answers null, never a guess.
How does autocomplete work?: Pass q= plus a ZIP, or a city and state, from the form. Browser calls rank the caller's home city first. A wrong guess reorders suggestions, it never hides a street.
Can a suggestion invent a house number?: No. A number appears only when it exists in the records. A street without a confirmed number suggests at street grain, number null.
What about apartments and units?: Units pass through and match registry unit rows when they exist. registered reflects the building.
What does junk return?: valid: false on a 200, never a 404.
What does deep add?: Nothing yet. ?deep=true returns an empty object, reserved.

SPEED

How long a lookup takes.

16ms

21ms

APAC

68ms

LatAm

19ms

112ms

See live status →

Coverage

United States, from official government records: about 90 million address points compiled from state and local 911 authorities.

United States

Coverage follows the records ZIP by ZIP. Where they stop, registered answers null, never a guess. Hawaii, Michigan, New Hampshire, and Nevada are not in the current compilation.

Get started Docs