US address lookup · Autocomplete
Address API
From a typed address
to useful fields.
Help people fill your forms. Standardize US street addresses, match official records and get the parts your app needs to store.
Start free. Lookup and autocomplete on every plan.
You have a full address. Whether it exists in official records.
Try it
The request and the result
One address.
A structured answer.
Look up a full address or suggest one as a person types. See matched records, missing matches and incomplete searches in the complete JSON.
An address your app can use.
Pass the full address as one string. Get its standardized parts, registry match and available coordinates.
Request
curl "https://api.parseapi.com/address/152%20200th%20Avenue%2C%20Ellsworth%20MN" \
-H "X-API-Key: YOUR_API_KEY"Example response
Address data for your app
One line in.
Useful parts out.
Fill city, state and ZIP from a selected suggestion. Store the same standardized fields when an address arrives from a form or a file.
- number
- 152
- street
- 200th Avenue
- city
- Ellsworth
- state
- MN
- postal
- 56129
Coverage
Match the address.
Keep the meaning clear.
Use valid for parsing and registered for the official record match. Available address-point coordinates let you put the matched location on a map.
Address referenceUS street addresses, checked against official records.
- United States
Coverage follows the published records. Registry matches do not confirm postal deliverability.
From the first request to your app
Your form.
One integration.
Start with a lookup or an autocomplete field. Use the same API key for both, alongside the other ParseAPI products your app needs.
HTTP, SDKs and MCP
Copy a request above or use an SDK in your language. The reference covers parameters, responses and errors. MCP brings Address to your agent workflow.
Before you build.
What does registered mean?
The address matches official records, either an address point or a mapped street-number range. A covered miss returns false. Missing coverage returns null. A registry match does not confirm postal deliverability or a supplied apartment.
Does valid mean the address exists?
valid means the input parses as an address. Use registered to read the registry match. Malformed input returns HTTP 200 with valid: false and null address parts.
Which addresses are covered?
US street addresses. Coverage follows the published official records. Lookup and autocomplete are included on every plan.
What should I pass for autocomplete?
Send q with a ZIP code, or with city and state from your form. A suggestion has a house number only when that number is recorded. Street suggestions can have number: null.
How should my form handle an empty list?
Keep manual entry available. reason can be more_input, missing_context or no_matches. An empty suggestion list does not establish address validity. HTTP 503 means suggestions are unavailable, so let the person retry.
What do the coordinates and county represent?
latitude and longitude come from a matched registry point. Street-number range matches return null coordinates. district and district_name identify the county associated with the ZIP code, rather than an exact county-boundary check.
What about apartments and units?
The supplied unit stays in the response. Where records have no unit detail, registered describes the building.
Can I add this to an existing form?
Yes. The address autocomplete tutorial covers a browser field, contextual searches and filling the selected address parts. Start at /tutorials/address-autocomplete.
Can I check a file of addresses?
Upload a file on /bulk/address with a full street-address column. Choose United States as its country, or include a country column with US for its rows. Standardized parts and registry matches come back as columns.
How are API requests counted?
Each lookup or autocomplete call uses one API request from your plan. The monthly allowance is shared across ParseAPI products. Free and paid plans both include Address lookup and autocomplete. See /plans for capacity.
Address API pricing
Better addresses.
From the first request.
Lookup and autocomplete on every plan. Each call uses one API request, with your monthly allowance shared across ParseAPI products.
Free
Start with a free API key.
Room to grow
Choose your capacity on Plans.