> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Geocodio

> Geocodio provides straightforward and easy-to-use geocoding, reverse geocoding, and data matching services for US and Canadian addresses.

![Geocodio logo](https://mintcdn.com/composio-preview/GL28i3tBlbEbBd-f/images/toolkits/geocodio.svg?fit=max\&auto=format\&n=GL28i3tBlbEbBd-f\&q=85\&s=5d4e3165c374e18c1cf51021b7589df3)

* **Category:** developer tools
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 7
* **Triggers:** 0
* **Slug:** `GEOCODIO`
* **Version:** 20261101\_00

## Tools

> [accordion] Batch Reverse Geocode
>
> **Slug:** `GEOCODIO_BATCH_REVERSE_GEOCODE`
>
> Tool to batch reverse geocode up to 10,000 coordinates in one request. Use when you need addresses for many lat/lon pairs.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Max number of candidate results per input; 0 means no limit. Must be non-negative.
>
> **fields** `string`
>
> Comma-separated data-append codes to include (e.g., 'cd,stateleg').
>
> **coordinates** `array` *required*
>
> List of 'latitude,longitude' strings. Latitude first. Up to 10,000 items.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Geocodio List
>
> **Slug:** `GEOCODIO_DELETE_LIST`
>
> Permanently delete a Geocodio spreadsheet list and its underlying data by ID. This can also cancel a processing list, subject to plan-specific cancellation restrictions.
>
> #### Input Parameters
>
> **list\_id** `integer` *required*
>
> The unique numeric ID of the Geocodio list to delete. Obtain this from the lists API (GET /lists) or from the response when creating a list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Batch Forward Geocode
>
> **Slug:** `GEOCODIO_GEOCODE_BATCH`
>
> Tool to batch geocode up to 10,000 addresses to coordinates in one request. Use when you need to convert multiple addresses to lat/lon coordinates. Optionally calculates distances to specified destinations for each geocoded result.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of results to return per address; 0 means no limit. Must be non-negative.
>
> **fields** `string`
>
> Comma-separated list of data-append codes to include (e.g., 'cd,timezone').
>
> **addresses** `array` *required*
>
> List of address strings to geocode. Up to 10,000 addresses.
>
> **destinations** `array`
>
> Array of destination locations for distance calculation. Each destination can be a coordinate string ('lat,lng' or 'lat,lng,id') or a geocodable address string.
>
> **distance\_mode** `string ("driving" | "straightline")`
>
> Distance calculation mode. Defaults to 'driving'.
>
> **distance\_units** `string ("miles" | "km")`
>
> Unit of measurement for distance filtering. Defaults to 'miles'.
>
> **distance\_order\_by** `string ("distance" | "duration")`
>
> Field to sort destinations by. Defaults to 'distance'.
>
> **distance\_sort\_order** `string ("asc" | "desc")`
>
> Sort order for destinations. Defaults to 'asc'.
>
> **distance\_max\_results** `integer`
>
> Maximum number of destinations to return per geocoded result.
>
> **distance\_max\_distance** `number`
>
> Maximum distance filter (in specified units).
>
> **distance\_max\_duration** `integer`
>
> Maximum duration filter in seconds (only applies to driving mode).
>
> **distance\_min\_distance** `number`
>
> Minimum distance filter (in specified units).
>
> **distance\_min\_duration** `integer`
>
> Minimum duration filter in seconds (only applies to driving mode).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Google Maps Compatible Geocode
>
> **Slug:** `GEOCODIO_GEOCODE_GOOGLE_MAPS_COMPATIBLE`
>
> Geocode an address or reverse geocode a coordinate using Geocodio's Google Maps-compatible response format. Requires a Geocodio API key supplied with the request.
>
> #### Input Parameters
>
> **key** `string` *required*
>
> Your Geocodio API key
>
> **latlng** `string`
>
> Latitude,longitude pair (for reverse geocoding). Required if address is not provided.
>
> **address** `string`
>
> Address to geocode (for forward geocoding). Required if latlng is not provided.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Sample Coordinates for Batch Reverse Geocode
>
> **Slug:** `GEOCODIO_GET_COORDINATES_FOR_BATCH_REVERSE_GEOCODE`
>
> Utility tool that returns a predefined list of sample US coordinates (latitude,longitude strings). Use this to obtain ready-to-use coordinate inputs for the batch reverse geocode action. The coordinates cover well-known US landmarks across different cities and states.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Single Forward Geocode
>
> **Slug:** `GEOCODIO_SINGLE_GEOCODE`
>
> Tool to forward geocode a single address. Use when you need coordinates and metadata for one address.
>
> #### Input Parameters
>
> **q** `string`
>
> Full address string to geocode; required if components not used
>
> **city** `string`
>
> City name
>
> **limit** `integer`
>
> Maximum number of results; 0 means no limit
>
> **state** `string`
>
> State or province code
>
> **county** `string`
>
> County name
>
> **fields** `string`
>
> Comma-separated list of data appends to include (e.g. 'timezone,cd')
>
> **format** `string`
>
> If 'simple', returns a flattened response schema
>
> **street** `string`
>
> Street address component
>
> **country** `string`
>
> Country context; USA or Canada
>
> **street2** `string`
>
> Secondary street address (unit etc)
>
> **postal\_code** `string`
>
> Postal (ZIP) code
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Single Reverse Geocode
>
> **Slug:** `GEOCODIO_SINGLE_REVERSE_GEOCODE`
>
> Tool to reverse geocode a single coordinate. Use when you need to convert one lat,lng to an address.
>
> #### Input Parameters
>
> **lat** `number` *required*
>
> Latitude of the coordinate, between -90 and 90
>
> **lng** `number` *required*
>
> Longitude of the coordinate, between -180 and 180
>
> **limit** `integer`
>
> Maximum number of results to return; 0 means no limit (default no limit)
>
> **fields** `string`
>
> Comma-separated list of data append codes to include (e.g., 'stateleg,timezone')
>
> **format** `string`
>
> Change output format; only valid value is 'simple' for a simplified response
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
