PostGrid Verify is an API that allows you to autocomplete, verify, and standardize addresses in real-time, supporting both individual and batch address verification.
PostGrid Verify is an API that allows you to autocomplete, verify, and standardize addresses in real-time, supporting both individual and batch address verification. On Nagent, PostGrid Verify is exposed as a fully-configurable developer tools integration that any agent can call — 12 actions, and API key authentication. No code is required to wire PostGrid Verify into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use PostGrid Verify 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 PostGrid Verify 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 PostGrid Verify, with input parameters and output schema. Drop these into any step of an agent built in Helix.
POSTGRID_VERIFY_AUTOCOMPLETE_ADDRESSTool to autocomplete a partially specified US or Canada address. Retrieves complete verified address including full postal code. Uses 1 lookup per request.
Input parameters
Optional parameter to retrieve the completion result at a particular index.
Only return addresses within this postal/zip code.
Only return addresses from this city.
Only return addresses within this province/state.
Only return addresses within this country.
The partially written address to autocomplete.
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
POSTGRID_VERIFY_AUTOCOMPLETE_INTL_ADDRESSTool to retrieve complete verified international address data using an ID from the preview endpoint. Use when you have an address ID from the preview step and need the full address details.
Input parameters
The ID previously returned from the preview endpoint where the type is 'Address'. Used to retrieve the complete verified address data.
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
POSTGRID_VERIFY_GET_AUTOCOMPLETE_PREVIEWSTool to get previews of autocompleted US and Canadian addresses. Returns partial address data (line1, city, first 3 digits of postal code) without using any lookups. Use when you need quick autocomplete suggestions for address input.
Input parameters
The country you want to filter the results by. Use ISO 2-letter country code (e.g., 'US' or 'CA')
The partially written street address to get autocomplete suggestions for
If true, returns the prov (province/state) field instead of the pc (postal code) field in preview objects
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
POSTGRID_VERIFY_GET_INTL_AUTOCOMPLETE_PREVIEWSTool to get previews of autocompleted international addresses. Results are biased based on your current IP address unless disabled. Returns both 'Address' and 'BuildingNumber' types - if type is 'Address', its id can be used in POST /completions; if 'BuildingNumber', use the container id with advanced previews.
Input parameters
Maximum number of results to return
The language preference of the results (e.g., EN, FR, ES)
The city you want to filter the results by
The street you want to filter the results by
The partially written street address to autocomplete
The countries you want to filter the results by. Supply ISO country code or the country's name. Separate multiple codes by comma.
Disables the IP of the request from being used as a starting point for the search. By default, results are biased based on your current IP address.
The postal code or zip code you want to filter the results by
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
POSTGRID_VERIFY_GET_LOOKUP_INFOTool to retrieve lookup usage information for your PostGrid account. Use when you need to check how many lookups you have used and your free lookup limit.
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
POSTGRID_VERIFY_LOOKUP_CITY_STATE_FROM_POSTALTool to lookup city and state for a given postal or ZIP code. Use when you need valid city/state combinations for a postal code.
Input parameters
The postal or ZIP code for which to retrieve city and state/province information
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
POSTGRID_VERIFY_PARSE_ADDRESSTool to break an address apart into its components. Use when you need to extract individual address parts like street number, road, city, state, and postal code from a single-line address string.
Input parameters
The address you want to parse on a single line.
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
POSTGRID_VERIFY_SUGGEST_ADDRESSESTool to find addresses similar to the given address. If the address can be verified or corrected, the first element will contain the verified address. Returns unit number ranges in line1 of suggested addresses. Use when you need address suggestions or corrections for US or Canadian addresses.
Input parameters
The address object containing details to find similar addresses for.
Include detailed address parsing in the response (streetName, streetType, streetDirection, streetNumber).
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
POSTGRID_VERIFY_VERIFY_ADDRESSTool to verify and standardize a US or Canadian address. Supports both freeform addresses (single-line) and structured addresses (with separate line1, city, etc.). Use includeDetails=true for additional metadata or geocode=true for latitude/longitude.
Input parameters
City name. Used with structured addresses.
First line of the address. Use for structured addresses. Either 'address' or 'line1' must be provided.
Second line of the address (optional). Only used with structured addresses.
Freeform address written on a single line (e.g., '22-20 bay st, floor 11, toronto, on'). Use this for unstructured addresses. Either 'address' or 'line1' must be provided.
ISO 2-letter country code (US or CA). Used with structured addresses.
If true, include geocoding data (latitude/longitude) in the response. Uses an additional lookup credit.
ZIP or postal code. Used with structured addresses.
If true, include additional address details in the response. Default is false.
State or province code (e.g., 'CA', 'ON'). Used with structured addresses.
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
POSTGRID_VERIFY_VERIFY_BATCH_ADDRESSESTool to verify up to 2000 US and Canada addresses in a single API call. Accepts both freeform address strings and structured address objects. Each address uses 1 lookup credit.
Input parameters
If true and your account has geocoding enabled, provides geolocation info (latitude/longitude).
List of addresses to verify. Each address can be either a freeform string or a structured object with fields (line1, city, etc). Maximum 2000 addresses per batch.
If true, returns the address in proper mixed case instead of uppercase.
If true, provides additional details about the address (street name, type, county, etc).
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
POSTGRID_VERIFY_VERIFY_INTERNATIONAL_ADDRESSTool to verify and standardize international addresses from 245+ countries. Supports both structured and freeform address inputs. Use includeDetails=true for match levels and geoData=true for coordinates.
Input parameters
The freeform international address to verify, written on a single line. Can include country, city, street, and postal code.
If true, includes geolocation information (latitude, longitude) and accuracy data for the verified address.
If true, provides additional details about the verified address including parsing and verification match levels.
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
POSTGRID_VERIFY_VERIFY_INTL_ADDRESSES_BATCHTool to verify up to 2000 international addresses in a single API call. Accepts both freeform address strings and structured address objects. Uses 1 lookup per address.
Input parameters
If true, include geolocation information (latitude, longitude, accuracy) in the response.
List of up to 2000 addresses to verify. Each address can be either a freeform string or a structured address object with individual components.
If true, provide additional details about each verified address.
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 96 agents privately built on Nagent that already use PostGrid Verify.
Build on Nagent
Connect PostGrid Verify 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 PostGrid Verify, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, PostGrid Verify is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once PostGrid Verify is connected, you configure its 12 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop PostGrid Verify 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 PostGrid Verify event fires, the agent kicks off automatically.
Every PostGrid Verify 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 PostGrid Verify ships with 12 pre-built developer tools actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching PostGrid Verify together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build PostGrid Verify-based workflows tailored to your business.