# Geocodio AI integration on Definable

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

## What this connects

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

Vendor: https://www.geocod.io/

## Tools available

**7** tools available. First 7:

- `GEOCODIO_BATCH_REVERSE_GEOCODE` — 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.
- `GEOCODIO_DELETE_LIST` — Delete Geocodio List — Permanently deletes a Geocodio spreadsheet list by its ID. Use this to cancel a processing list job or remove a completed list. This action is destructive and cannot be undone. The list_id must be obtained from the lists API or from when the list was created.
- `GEOCODIO_GEOCODE_BATCH` — Batch Forward Geocode — 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.
- `GEOCODIO_GEOCODE_GOOGLE_MAPS_COMPATIBLE` — Google Maps Compatible Geocode — Tool to geocode addresses using Google Maps-compatible API format. Use when you need a drop-in replacement for Google Maps Geocoding API for US and Canada addresses.
- `GEOCODIO_GET_COORDINATES_FOR_BATCH_REVERSE_GEOCODE` — Get Sample 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.
- `GEOCODIO_SINGLE_GEOCODE` — Single Forward Geocode — Tool to forward geocode a single address. Use when you need coordinates and metadata for one address.
- `GEOCODIO_SINGLE_REVERSE_GEOCODE` — Single Reverse Geocode — Tool to reverse geocode a single coordinate. Use when you need to convert one lat,lng to an address.

## Auth

Auth schemes: `API_KEY`.

## How agents use Geocodio

Inside a Definable workflow, Geocodio is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Geocodio** — the Researcher (GPT-5.5) pulls context from Geocodio (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Geocodio** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Geocodio (create record, post message, draft email).
- **Designer / Engineer → Distributor → Geocodio** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Geocodio (attach file, open PR comment, post status).

The Verifier checks every Geocodio call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- developer tools — https://definable.ai/apps/category/developer-tools/

## Related

- HTML page: https://definable.ai/apps/geocodio/
- Same category (developer tools): https://definable.ai/apps/category/developer-tools/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt
