Geocoding

Batch geocode — up to 50 addresses in one call

Geocode multiple addresses in one request with structured per-row results (per-row errors never fail the batch). Costs 1 quota unit per call — the same debit the MCP batch_geocode tool applies. Canonical path; POST /v1/geocode/batch is a retained alias with the identical contract.

post/v1/batch

Request

Base URL: https://geo.thinair.co
URL: https://geo.thinair.co/v1/batch
Auth: HTTP bearer

Request body

addressesstring[] required

Addresses to geocode, in order (1–50 per batch). Empty rows are echoed back as per-row empty_address errors rather than failing the batch.

Example request

{
  "addresses": [
    "1600 Pennsylvania Ave NW, Washington, DC",
    "Austin, TX"
  ]
}

Response

Per-row batch results (successes and failures interleaved, input order preserved).

Changes

No recorded changes to this operation across all 1 revision of this API.