v1

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

Batch reverse geocode coordinates

post/reverse

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

skipGeocodingstring

When set, skips reverse geocoding and applies field appends directly to the coordinates. Requires the fields parameter.

limitinteger

Maximum number of results per coordinate

countrystring

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

Request body

string[] required

List of "lat,lng" strings

OR
object required

Coordinates keyed by custom identifier

Response

Successful response