---
title: "GET /v1/addver/completions"
method: GET
path: "/v1/addver/completions"
tags: ["Standard API"]
---

# GET /v1/addver/completions

`GET /v1/addver/completions`

Returns address completion previews for a partial street address, suitable
for populating an autocomplete dropdown without consuming a lookup per keystroke.

Each result contains a partial address preview (street, city, and — for non-US
addresses — only the first 3 digits of the postal code, to avoid revealing the
full code before a lookup is charged).

- Does not consume a lookup.
- Use `POST /completions` to resolve a full address once the user selects a result.

## Query parameters

- `partialStreet` string, required
- `cityFilter` string
- `stateFilter` string
- `pcFilter` string
- `countryFilter` string
- `properCase` boolean
- `verifiedOnly` boolean
- `filterExact` boolean
- `limit` integer
- `provInsteadOfPC` boolean

## Response `200`

The request has succeeded.

- object
  - `status` 'success' | 'error', required
  - `message` string, required
  - `data` CompletionPreviewItem[], required
    - `preview` object, required — A partial view of the address, suitable for display in an autocomplete dropdown.
      - `address` string, required — The street address line.
      - `city` string — The city.
      - `pc` string — For US addresses, the full postal code. For non-US addresses, only the first 3 digits are returned to avoid consuming a lookup.
      - `prov` string — The province or state abbreviation. Returned instead of `pc` when `provInsteadOfPC=true`.

## Other responses

- `400` — The server could not understand the request due to invalid syntax.

---

[API](https://skmtc.net/postgrid/apis/postgrid-address-verification-api.md) · [All operations](https://skmtc.net/postgrid/apis/postgrid-address-verification-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/postgrid/postgrid-address-verification-api/versions/537d2bbc624a/schema)