Geocodio provides straightforward and easy-to-use geocoding, reverse geocoding, and data matching services for US and Canadian addresses.
Geocodio provides straightforward and easy-to-use geocoding, reverse geocoding, and data matching services for US and Canadian addresses. On Nagent, Geocodio is exposed as a fully-configurable developer tools integration that any agent can call — 7 actions, and API key authentication. No code is required to wire Geocodio into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Geocodio to automate the kinds of tasks developer tools teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Geocodio into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Geocodio, with input parameters and output schema. Drop these into any step of an agent built in Helix.
GEOCODIO_BATCH_REVERSE_GEOCODETool to batch reverse geocode up to 10,000 coordinates in one request. Use when you need addresses for many lat/lon pairs.
Input parameters
Max number of candidate results per input; 0 means no limit. Must be non-negative.
Comma-separated data-append codes to include (e.g., 'cd,stateleg').
List of 'latitude,longitude' strings. Latitude first. Up to 10,000 items.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GEOCODIO_DELETE_LISTPermanently 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.
Input parameters
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GEOCODIO_GEOCODE_BATCHTool 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
Maximum number of results to return per address; 0 means no limit. Must be non-negative.
Comma-separated list of data-append codes to include (e.g., 'cd,timezone').
List of address strings to geocode. Up to 10,000 addresses.
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 calculation mode. Defaults to 'driving'.
Unit of measurement for distance filtering. Defaults to 'miles'.
Field to sort destinations by. Defaults to 'distance'.
Sort order for destinations. Defaults to 'asc'.
Maximum number of destinations to return per geocoded result.
Maximum distance filter (in specified units).
Maximum duration filter in seconds (only applies to driving mode).
Minimum distance filter (in specified units).
Minimum duration filter in seconds (only applies to driving mode).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GEOCODIO_GEOCODE_GOOGLE_MAPS_COMPATIBLETool 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.
Input parameters
Your Geocodio API key
Latitude,longitude pair (for reverse geocoding). Required if address is not provided.
Address to geocode (for forward geocoding). Required if latlng is not provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GEOCODIO_GET_COORDINATES_FOR_BATCH_REVERSE_GEOCODEUtility 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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GEOCODIO_SINGLE_GEOCODETool to forward geocode a single address. Use when you need coordinates and metadata for one address.
Input parameters
Full address string to geocode; required if components not used
City name
Maximum number of results; 0 means no limit
State or province code
County name
Comma-separated list of data appends to include (e.g. 'timezone,cd')
If 'simple', returns a flattened response schema
Street address component
Country context; USA or Canada
Secondary street address (unit etc)
Postal (ZIP) code
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GEOCODIO_SINGLE_REVERSE_GEOCODETool to reverse geocode a single coordinate. Use when you need to convert one lat,lng to an address.
Input parameters
Latitude of the coordinate, between -90 and 90
Longitude of the coordinate, between -180 and 180
Maximum number of results to return; 0 means no limit (default no limit)
Comma-separated list of data append codes to include (e.g., 'stateleg,timezone')
Change output format; only valid value is 'simple' for a simplified response
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 85 agents privately built on Nagent that already use Geocodio.
Build on Nagent
Connect Geocodio to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Geocodio, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Geocodio is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Geocodio is connected, you configure its 7 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Geocodio steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Geocodio event fires, the agent kicks off automatically.
Every Geocodio action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Geocodio ships with 7 pre-built developer tools actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Geocodio together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Geocodio-based workflows tailored to your business.