Validate up to 200 addresses in one request
Synchronous bulk variant of /validate. Each address is fanned out in-process to the real POST /validate route, so every result — and its billing — is byte-identical to a standalone call. Billing is per row: each address consumes one address-validation transaction (Stripe-plan transaction; the trial pool decrements 1 regardless). There is no submit-time 403 — if the key runs out of transactions, is over quota, or is invalid, that surfaces inside the individual result entry rather than failing the whole batch. Requires an API key (the anonymous free-tier IP path is for POST /validate only). For larger volumes, submit an async job via POST /validate/jobs.
Request
- Base URL: https://api.acuris-geo.com
- URL: https://api.acuris-geo.com/validate/batch
- Auth: one of:
- API key in header X-Acuris-Key
- HTTP bearer
- API key in header X-API-Key
- API key in query parameter key
- none
Request body
Example request
{
"country": "deu",
"addresses": [
"Eckenbertstraße 31, 67549 Worms",
{
"input": "1600 Pennsylvania Ave NW, Washington, DC 20500",
"country": "usa"
}
]
}Response
Per-address results. Individual entries may themselves carry an error (e.g. insufficient_validation_credits) — inspect each result.
Example response
{
"results": [
{
"nearby_house_numbers": {
"requested": "46",
"before": {
"hno": "44"
},
"after": {
"hno": "44"
},
"pin_between": [
"44",
"50"
]
},
"street_postcodes": [
{
"postcode": "9573 PA",
"house_number_from": 3,
"house_number_to": 22
}
],
"postcode_range": {
"from": "9573 PA",
"to": "9573 PH",
"text": "from 9573 PA to 9573 PH"
},
"landmark_used": {
"name": "Patiala House",
"matched_from": "Patiala House",
"source": "Overture Maps Foundation (CDLA-Permissive-2.0)"
}
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.