Authentication

You'll need to authenticate your requests to access any of the endpoints in the Addressfully API. In this guide, we'll look at how authentication works.

Authorization with API Keys

To authenticate with the Addressfully API, you will use the authorization header. To make calls, you will need your API key — which you can find in Account Settings under API Keys. Here's how to add the API key to the request header using cURL:

curl -G https://us-address.addressfully.com/address-lookup/v1/addresses/lookup \
    -H "Authorization: Bearer {api_key}" \
    -d street_address="1250 Prospect St" \
    -d apt_suite_other="" \
    -d city="La Jolla" \
    -d state="CA" \
    -d zip_code="92037" \
    -d country="US"

This API key should only be used in server-side applications and never exposed in client-side code or public repositories. Always keep your API key safe and reset it immediately if you suspect it has been compromised.