DocsAPI DocumentationAddress Autocomplete API

Address Autocomplete API

GET /v1/address/autocomplete

Fast, typo-tolerant address auto-completion endpoint for input search boxes.

Updated: July 20261 min read

Endpoint Overview

GET /v1/address/autocomplete

Provides instant sub-150ms address suggestions as a user types into an input field.

query (string, required): Partial address prefix or search string.
country (string, optional, default: NG): Two-letter ISO 3166-1 alpha-2 country code.
limit (number, optional, default: 5): Maximum number of candidate suggestions to return (1-20).

1
2
curl -X GET "https://api.addressvalid.io/v1/address/autocomplete?query=14+Admiralty&limit=3" \
  -H "Authorization: Bearer sk_live_key"

Your feedback helps us continuously improve our developer docs.