GET /address/{address} · ?q=

Address 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

108ms

EU

142ms

APAC

209ms

LatAm

198ms

ME

133ms

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

addressstring or null
Standardized address line
validboolean
Input parses as a US address. Junk returns valid: false on a 200, never a 404
registeredboolean or null
Matches official records, including mapped street-number ranges. Null for missing coverage. Not a deliverability claim
numberstring or null
House number
streetstring or null
Standardized street line
unitstring or null
Unit as given. registered reflects the building when the records have no unit rows
citystring or null
City name
districtstring or null
District code (US county FIPS)
district_namestring or null
District name
statestring or null
State code
state_namestring or null
State name
postalstring or null
US ZIP code
countrystring or null
ISO2 country code (US)
country_namestring or null
Country name
latitudenumber or null
Published registry latitude; null for range matches or absent coordinates
longitudenumber or null
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.

Ready for busy moments.Start includes 1,800 requests per minute, with extra capacity for bursts. Rate limits

Get startedCompare plansRead the docs