v1

latestOpenAPI 3.0.1Geocodio Terms of Use2026-08-061785720.4 KB
geocode

Batch geocode addresses

post/geocode

Query parameters

fieldsstring[]

Comma-separated list of data append fields. See the enum for valid values.

destinations[]string[]

Array of destination locations for distance calculation

distance_mode'driving' | 'straightline'

Distance calculation mode

distance_units'miles' | 'km'

Unit of measurement for distance values

distance_max_resultsinteger

Maximum number of destinations to return per result

distance_max_distancenumber

Maximum distance filter (in specified units)

distance_max_durationinteger

Maximum duration filter in seconds

distance_min_distancenumber

Minimum distance filter (in specified units)

distance_min_durationinteger

Minimum duration filter in seconds

distance_order_by'distance' | 'duration'

Field to sort destinations by

distance_sort_order'asc' | 'desc'

Sort order for destinations

limitinteger

Maximum number of results per address

countrystring

Default country code applied to every query in the batch unless a query provides its own

Request body

string[] required

List of address strings

OR
object required

Addresses keyed by custom identifier

Response

Successful response