# PostGrid Verify

PostGrid Verify is an API that allows you to autocomplete, verify, and standardize addresses in real-time, supporting both individual and batch address verification.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 12
- **Triggers:** 0
- **Slug:** `POSTGRID_VERIFY`
- **Version:** 20260312_00

## Tools

### Autocomplete Address

**Slug:** `POSTGRID_VERIFY_AUTOCOMPLETE_ADDRESS`

Tool to autocomplete a partially specified US or Canada address. Retrieves complete verified address including full postal code. Uses 1 lookup per request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `index` | string | No | Optional parameter to retrieve the completion result at a particular index. |
| `pcFilter` | string | No | Only return addresses within this postal/zip code. |
| `cityFilter` | string | No | Only return addresses from this city. |
| `stateFilter` | string | No | Only return addresses within this province/state. |
| `countryFilter` | string | No | Only return addresses within this country. |
| `partialStreet` | string | Yes | The partially written address to autocomplete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Autocomplete International Address

**Slug:** `POSTGRID_VERIFY_AUTOCOMPLETE_INTL_ADDRESS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The ID previously returned from the preview endpoint where the type is 'Address'. Used to retrieve the complete verified address data. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Autocomplete Previews

**Slug:** `POSTGRID_VERIFY_GET_AUTOCOMPLETE_PREVIEWS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `countryFilter` | string | No | The country you want to filter the results by. Use ISO 2-letter country code (e.g., 'US' or 'CA') |
| `partialStreet` | string | No | The partially written street address to get autocomplete suggestions for |
| `provInsteadOfPC` | boolean | No | If true, returns the prov (province/state) field instead of the pc (postal code) field in preview objects |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get International Autocomplete Previews

**Slug:** `POSTGRID_VERIFY_GET_INTL_AUTOCOMPLETE_PREVIEWS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return |
| `language` | string | No | The language preference of the results (e.g., EN, FR, ES) |
| `cityFilter` | string | No | The city you want to filter the results by |
| `streetFilter` | string | No | The street you want to filter the results by |
| `partialStreet` | string | No | The partially written street address to autocomplete |
| `countriesFilter` | string | No | The countries you want to filter the results by. Supply ISO country code or the country's name. Separate multiple codes by comma. |
| `disableIPBiasing` | boolean | No | 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. |
| `postalOrZipFilter` | string | No | The postal code or zip code you want to filter the results by |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Lookup Info

**Slug:** `POSTGRID_VERIFY_GET_LOOKUP_INFO`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Lookup City and State from Postal Code

**Slug:** `POSTGRID_VERIFY_LOOKUP_CITY_STATE_FROM_POSTAL`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `postalOrZip` | string | Yes | The postal or ZIP code for which to retrieve city and state/province information |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Parse Address

**Slug:** `POSTGRID_VERIFY_PARSE_ADDRESS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `address` | string | Yes | The address you want to parse on a single line. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Suggest Addresses

**Slug:** `POSTGRID_VERIFY_SUGGEST_ADDRESSES`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `address` | object | Yes | The address object containing details to find similar addresses for. |
| `includeDetails` | string | No | Include detailed address parsing in the response (streetName, streetType, streetDirection, streetNumber). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Verify Address

**Slug:** `POSTGRID_VERIFY_VERIFY_ADDRESS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `city` | string | No | City name. Used with structured addresses. |
| `line1` | string | No | First line of the address. Use for structured addresses. Either 'address' or 'line1' must be provided. |
| `line2` | string | No | Second line of the address (optional). Only used with structured addresses. |
| `address` | string | No | 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. |
| `country` | string | No | ISO 2-letter country code (US or CA). Used with structured addresses. |
| `geocode` | boolean | No | If true, include geocoding data (latitude/longitude) in the response. Uses an additional lookup credit. |
| `postalOrZip` | string | No | ZIP or postal code. Used with structured addresses. |
| `includeDetails` | boolean | No | If true, include additional address details in the response. Default is false. |
| `provinceOrState` | string | No | State or province code (e.g., 'CA', 'ON'). Used with structured addresses. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Batch Verify Addresses with Mixed Format

**Slug:** `POSTGRID_VERIFY_VERIFY_BATCH_ADDRESSES`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `geocode` | boolean | No | If true and your account has geocoding enabled, provides geolocation info (latitude/longitude). |
| `addresses` | array | Yes | 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. |
| `properCase` | boolean | No | If true, returns the address in proper mixed case instead of uppercase. |
| `includeDetails` | boolean | No | If true, provides additional details about the address (street name, type, county, etc). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Verify International Address

**Slug:** `POSTGRID_VERIFY_VERIFY_INTERNATIONAL_ADDRESS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `address` | string | Yes | The freeform international address to verify, written on a single line. Can include country, city, street, and postal code. |
| `geoData` | boolean | No | If true, includes geolocation information (latitude, longitude) and accuracy data for the verified address. |
| `includeDetails` | boolean | No | If true, provides additional details about the verified address including parsing and verification match levels. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Batch Verify International Addresses

**Slug:** `POSTGRID_VERIFY_VERIFY_INTL_ADDRESSES_BATCH`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `geoData` | boolean | No | If true, include geolocation information (latitude, longitude, accuracy) in the response. |
| `addresses` | array | Yes | List of up to 2000 addresses to verify. Each address can be either a freeform string or a structured address object with individual components. |
| `includeDetails` | boolean | No | If true, provide additional details about each verified address. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |