Acuris Address Validation & Geocoding
Address validation and forward/reverse geocoding for **all 249 countries and territories** — complete ISO 3166-1 coverage. Every response includes an explicit `accuracy_type` field — `rooftop`, `street`, `street_centroid`, `postcode_centroid`, or `locality_centroid` — so you always know exactly what precision you got. No silent fallbacks, no guessing. **Rooftop coverage** for all major markets…
2 subscribers
8.8/10 popularity
618 ms avg latency
80% success rate
30 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
Acuris Address Validation & Geocoding endpoints
| Method | Endpoint | Description |
|---|---|---|
| Validation | ||
| POST |
validateAddress /validate |
Accepts a single-line address string **or** structured fields in `input`, plus required `country` (ISO-style code). **Credits:** One validation consumes one anonymous slot (if no… |
| GET |
validateCredits /validate-credits |
Returns how many **free** validations remain for this IP today (UTC-based server tracking). |
| Geocoding | ||
| GET |
geocodeUsa /geocode-usa |
Same as `/geocode?country=usa` with `city` and `state` parameters. |
| GET |
reverseGeocode /reverse |
Finds the nearest known address to a given `lat`/`lng` within `radius_m` metres from the reference database. Results are sorted by distance ascending and include a `distance_m`… |
| GET |
geocode /geocode |
Provide `country` and address components. For countries with regions (USA, Canada), **state** / province is required together with city and street. **Credits:** One geocode… |
| GET |
geocodeCredits /geocode-credits |
Without `password`: returns `free_remaining` anonymous geocodes for this IP. With valid `password`: returns account `balance`; `free_remaining` may be null. |
| Suggest | ||
| GET |
suggest /suggest |
Returns a list of suggestion strings for prefix `q` (or `prefix`) and `country`. Rate limited (100/day per IP by default). |
| Account | ||
| GET |
checkKey /check-key |
Returns whether the key is active and current credit balance. |
| Config | ||
| GET |
countryConfig /api/country-config |
Returns UPU-oriented field order and optional examples per country for building address forms. |
| Search | ||
| GET |
search /search |
**Advanced:** primarily for internal or partner tooling. Requires a valid API key for some modes. Parameters include `city`, `state`, `radius`, `street`, `hno`, `mode` (`heatmap`… |
| Other endpoints | ||
| POST |
validateAddress /validate |
Validates and standardizes a postal address against the Acuris reference database. Returns a match score, match type, corrected address fields, and per-component confirmation of… |
| POST |
geocodeAddress /geocode |
Converts a postal address to latitude/longitude coordinates. Returns the best available coordinate type with a match score indicating confidence. Results may be stored… |
| GET |
suggestAddresses /suggest |
Returns up to 50 address suggestions for a partial input string. Use for real-time typeahead in address entry forms. Suggestions are sorted by relevance score descending. |
| GET |
/reverse /reverse |
Finds the nearest known address to a given `lat`/`lng` within `radius_m` metres from the reference database. Results are sorted by distance ascending and include a `distance_m`… |
| GET |
/geocode-credits /geocode-credits |
Without `password`: returns `free_remaining` anonymous geocodes for this IP. With valid `password`: returns account `balance`; `free_remaining` may be null. |
| GET |
/geocode-usa /geocode-usa |
Same as `/geocode?country=usa` with `city` and `state` parameters. |
| GET |
/validate-credits /validate-credits |
Returns how many **free** validations remain for this IP today (UTC-based server tracking). |
| GET |
/geocode /geocode |
Provide `country` and address components. For countries with regions (USA, Canada), **state** / province is required together with city and street. **Credits:** One geocode… |
| POST |
/validate /validate |
Accepts a single-line address string **or** structured fields in `input`, plus required `country` (ISO-style code). **Credits:** One validation consumes one anonymous slot (if no… |
| GET |
/api/country-config /api/country-config |
Returns UPU-oriented field order and optional examples per country for building address forms. |
| POST |
validateAddress /validate |
Validates and standardizes a postal address against the Acuris reference database. Returns a match score, match type, corrected address fields, and per-component confirmation of… |
| POST |
geocodeAddress /geocode |
Converts a postal address to latitude/longitude coordinates. Returns the best available coordinate type with a match score indicating confidence. Results may be stored… |
| GET |
suggestAddresses /suggest |
Returns up to 50 address suggestions for a partial input string. Use for real-time typeahead in address entry forms. Suggestions are sorted by relevance score descending. |
| GET |
/reverse /reverse |
Finds the nearest known address to a given `lat`/`lng` within `radius_m` metres from the reference database. Results are sorted by distance ascending and include a `distance_m`… |
| GET |
/geocode-credits /geocode-credits |
Without `password`: returns `free_remaining` anonymous geocodes for this IP. With valid `password`: returns account `balance`; `free_remaining` may be null. |
| GET |
/geocode-usa /geocode-usa |
Same as `/geocode?country=usa` with `city` and `state` parameters. |
| GET |
/geocode /geocode |
Provide `country` and address components. For countries with regions (USA, Canada), **state** / province is required together with city and street. **Credits:** One geocode… |
| POST |
/validate /validate |
Accepts a single-line address string **or** structured fields in `input`, plus required `country` (ISO-style code). **Credits:** One validation consumes one anonymous slot (if no… |
| GET |
/validate-credits /validate-credits |
Returns how many **free** validations remain for this IP today (UTC-based server tracking). |
| GET |
/api/country-config /api/country-config |
Returns UPU-oriented field order and optional examples per country for building address forms. |
Acuris Address Validation & Geocoding pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 2 / minute |
|
| PRO | $59 / month | 10 / second |
|
| ULTRA | $179 / month | 25 / second |
|
| MEGA | $699 / month | 100 / second |
|
