Geocode an address

Resolves address-like queries in Google ranking order. Anonymous access returns at most three candidates; authenticated access retains up to five provider candidates. The API does not choose a conversational answer. Strict DTO by default; legacy requires public_contract=legacy. See /docs/PUBLIC_API_MIGRATION.md. Explicit public_contract=roote-1.1.0 selects the freeze-ready whitelist and qualified EMPTY semantics; existing default/version/legacy responses remain compatible. Unknown source freshness does not establish operational availability. Internal acquisition/matching metadata is excluded from the freeze-ready projection.

get/v1/geocode

Request

  • Base URL: https://api.roote.ai
  • URL: https://api.roote.ai/v1/geocode
  • Auth: one of:
    • none
    • HTTP bearer

Query parameters

qstring required
languagestring
countrystring
tokenstring

Compatibility API token; prefer Authorization Bearer.

public_contract'roote-1.0.0' | 'legacy' | 'roote-1.1.0'

Omit for strict DTO. Version remains an explicit alias. legacy is deprecated; no silent fallback.

Response

Strict public DTO (default and explicit version alias).

OR
OR

Changes

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