GET /address/{address} · ?q=

Address lookup API

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

Try it

Example response/address/152%20200th%20Avenue%2C%20Ellsworth%20MN
{
  "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
}

1M requests · $20/mo. Get started

What comes back.

valid

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

registered

Matches official records, including mapped street-number ranges. Null for missing coverage. 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

US ZIP code

latitude

Published registry latitude; null for range matches or absent coordinates

longitude

Published registry longitude; null for range matches or absent coordinates

q

The partial input as typed

addresses

Ranked suggestions, same parts as lookup

1

Pass the address

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

2

Get the verdict

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

3

Autocomplete included

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

Coverage

US street addresses, checked against official records.

  • United States

Coverage follows the published records. Registry matches do not confirm postal deliverability.

90M+
address points
US
official address 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 a match in official records. It does not establish postal deliverability.

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.

SPEED

How long /address takes.

Median time to first byte over the last seven days. Warm requests, measured every 30 minutes. Live verification and other request variants can take longer.

US

88ms

EU

168ms

APAC

193ms

LatAm

188ms

ME

117ms

See live status →

Make your first request.

One key works across the APIs. Copy a request in your language and get JSON back.

curl "https://api.parseapi.com/address/152%20200th%20Avenue%2C%20Ellsworth%20MN" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Parse-Version: 2.0.0"
// Example response · 200
{
  "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
}

API referenceSDKsKeys and authentication

Every response field

Response fields

address
Standardized address line
valid
Input parses as a US address. Junk returns valid: false on a 200, never a 404
registered
Matches official records, including mapped street-number ranges. Null for missing coverage. 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
US ZIP code
country
ISO2 country code (US)
country_name
Country name
latitude
Published registry latitude; null for range matches or absent coordinates
longitude
Published registry longitude; null for range matches or absent coordinates

Build with Address

All tutorials →

QUESTIONS

Can I check a CSV?
Yes. Drop a file on /bulk with a full street-address column. Choose United States as its country, or include a country column with US for its address rows. Registry matches and standardized parts come back as columns.
When do I use which?
A full address for the registered verdict. q= for autocomplete as the form is typed.
What does registered mean?
The address matches official records. US matches can come from an address point or a mapped street-number range. This does not confirm postal deliverability or a supplied apartment.
Which addresses are covered?
The United States. Coverage follows the published records. An unknown scope returns registered: null.
How does autocomplete work?
Pass q= with a ZIP code, or a city and state from the form. Searches can also use the caller IP for ranking. Suggestions only include house numbers found in the records.
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.

Find the address.

US address parsing and matching. Every plan.

Start includes 1M API requests a month for $20/mo.

Get startedCompare plansRead the docs