Skip to main content

Addressfinder APIs Overview

This is a lightweight web service (REST interface), which provides an easy way to access and use every Addressfinder email, phone and address verification service.

Not a developer? Use Addressfinder's low and no-code integrations.

Quick start

Make your first API call in minutes: log in to your account or sign up for a 30-day free trial to get your credentials and register your domains in the Portal (localhost is included by default).

Usage is billed per successful Lookup, not per API call. One Lookup is counted each time a verified result is returned.

Authentication

Addressfinder supports three authentication methods. For full details see the Authentication Guide.

  1. API key + Registered Domain: for browser-based calls, register your domain in the Portal and use your API key alone.
  2. API key + Secret: include your key as a query parameter and pass your secret in the Authorization header. For server-to-server calls only, never expose your secret in client-side code.
  3. OAuth2 Bearer Token: for teams with stricter security requirements, use the OAuth2 client credentials grant to obtain a short-lived JWT access token. Available on Business or Enterprise plans. Contact us to enable.

OpenAPI spec

Addressfinder publishes a full OpenAPI Specification for all API endpoints. Use it to:

  • Import directly into Postman or Insomnia to explore and test endpoints
  • Feed into an LLM to generate integration code in your language of choice
  • Generate client SDK stubs using openapi-generator
  • Connect via iPaaS platforms like Zapier or Make

Error codes

For a full list of API error codes see the Error codes reference.

Address APIs

Address autocomplete APIs - AU, NZ, INT

Interactive search that returns closely matching addresses which are then selected by the user

Address metadata APIs - AU, NZ, INT

Return the full metadata associated with an address selected from the address autocomplete API

Address verification APIs - AU, NZ

The address verification API receives a full address from your system and attempts to match it with a verified address in the Addressfinder database. If successful, it returns the matched address and associated metadata.

Location autocomplete APIs - AU, NZ

Interactive search that returns closely matching streets, suburbs and/or states which are then selected by the user

Location metadata APIs - AU, NZ

Return the full metadata associated with a location (street, suburb or state) selected from the location autocomplete API

Address reverse geocode APIs - NZ

Takes the GPS coordinates (longitude and latitude) and returns the nearest addresses ordered by distance

Points of interest autocomplete APIs - NZ

Interactive search that returns closely matching points of interest and their associated addresses

Points of interest metadata APIs - NZ

Return the full metadata associated with a point of interest selected from the points of interest autocomplete API

Email verification API

Takes an email address and validates the syntax, the existence and availability of the domain, existence of the email account, and returns a verified state and other metadata. View the Email verification API

Phone verification API

Verifies a supplied number through a process which involves syntax and range checks prior to a network check for a connection status. View the Phone verification API

Performance

Addressfinder is load tested to handle in excess of 10,000 requests per minute and scales horizontally to meet demand. If you are expecting a high-volume launch, let us know in advance so we can prepare accordingly.

If you have questions or find a bug, contact us at support@addressfinder.com.