Guides
for everything Geocodio
Guides
Address completion
Guides
for everything Geocodio
Address completion
Geocodio can be used to complete incomplete addresses. You can submit full addresses in different formats as well as incomplete addresses.
As long as you supply at least Street + City + State/Province or Street/postal code, Geocodio can return a full completed and standardized address street, city, state, zip and county. In 90% of cases, these combinations will have a result that is either on the exact rooftop or in front of the parcel on the street. If only a city/state or postal code is given, a centroid will be returned. (See more about accuracy here.)
Acceptable Inputs for US Addresses
| Address components supplied | Example |
|---|---|
| Street/City/State, directional and street type abbreviated | 1109 N Highland St, Arlington VA |
| Street/City/State, directional abbreviated, street type spelled out | 1109 N Highland Street, Arlington VA |
| Street/City/State, both direction and street type spelled out | 1109 North Highland Street, Arlington VA |
| Street/ZIP code | 1109 N Highland St, 22201 |
| City/State | Arlington, VA |
| City | Arlington |
| County | Santa Clara County |
| Street/County | 1 Infinite Loop, Santa Clara County |
| Street/County/State | 1 Infinite Loop, Santa Clara County, CA |
| Street/County/State | 1 Infinite Loop, Santa Clara County, CA |
| Street/County/City/State | 1 Infinite Loop, Santa Clara County, Cupertino CA |
| State | VA |
| ZIP Code | 22201 |
Acceptable Inputs for Canadian Addresses
Note that addresses in Canada must include "Canada" (exactly, not abbreviated).
| Address components supplied | Example |
|---|---|
| Street/City/Province/Postal Code/Country, directional and street type abbreviated | 230 Marquis Dr W, Saskatoon, SK, S7R 1B7, Canada |
| Street/City/Province/Postal Code/Country, directional abbreviated, street type spelled out | 230 Marquis Drive W, Saskatoon, SK, S7R 1B7, Canada |
| Street/City/Province/Postal Code/Country, both direction and street type spelled out | 230 Marquis Drive West, Saskatoon, SK, S7R 1B7, Canada |
| Street/City/Province/Country | 230 Marquis Drive West, Saskatoon, SK, Canada |
| Street/Postal Code/Country | 230 Marquis Drive West, S7R 1B7, Canada |
| City/Province/Country | Arlington, VA |
| City/Country | Saskatoon, Canada |
| Street address or city missing French accent | Levis, Quebec, Canada (should be Lévis, will be corrected) |
| Province/Country | Saskatoon, Canada |
| Postal Code/Country | S7R 1B7, Canada |
Acceptable Inputs for UK Addresses
| Address components supplied | Example |
|---|---|
| Street/Postcode | 10 Downing Street, SW1A 2AA |
| Street/City/Postcode | 10 Downing Street, London, SW1A 2AA |
| Postcode only | SW1A 2AA |
| Street/City | 10 Downing Street, London |
| City | London |
Acceptable Inputs for Australian Addresses
| Address components supplied | Example |
|---|---|
| Street/Suburb/State/Postcode | 100 St Georges Terrace, Perth WA 6000, AU |
| Unit/Street/Suburb/State/Postcode | 2/20 Koornang Road, Carnegie VIC 3163, AU |
| Postcode only | 6000, AU |
Acceptable Inputs for New Zealand Addresses
| Address components supplied | Example |
|---|---|
| Street/Suburb/City/Postcode | 50-60 Ash Street, Avondale, Auckland 1026, NZ |
| Street/Town/Postcode | 94 Heuheu St, Taupō 3330, NZ |
| Postcode only | 3330, NZ |
Notes
If a city is given without a street or state/province, the city with the largest population will be assumed.
If a country is not specified in the query, Geocodio will assume the country to be USA. UK queries should include the postcode or otherwise make the country clear (or pass
country=GBexplicitly).For UK addresses, a postcode alone is often enough to resolve to a specific location, since postcodes are much more precise than US ZIP codes. A full postcode typically narrows to a small group of neighboring addresses rather than a wide area.
For UK addresses, an outward code alone (e.g. "SW1A" without the rest of the postcode) returns the broader area it covers, not a single address.
For UK addresses, county alone is not a reliable input and may not return a usable result; pair it with at least a city or postcode.
Australian and New Zealand queries should include the country (for example, AU or NZ) in the address. Like UK queries, if the country is missing, Geocodio will assume the country to be USA.
For Australian addresses, write unit numbers with a slash (1/201 is Unit 1 at 201). Geocodio also recognizes state abbreviations (NSW, VIC, QLD, SA, WA, TAS, NT, ACT) and Australia Post street types like Tce, Cct, Pde, and Bvd.
A postcode alone returns the centre of that postal area, not a specific address. Australian and New Zealand postcodes cover a suburb or a group of suburbs, so they’re less precise than UK postcodes.
For New Zealand addresses, Geocodio returns the town or city (for example, Auckland). Suburbs are accepted as input, and place names keep their macrons (Taupō).
Please note that at this time, Geocodio is not CASS certified by USPS. If you require CASS-certified address completion, such as for shipping purposes, a different vendor may be a better fit.