Quickstart

1. Get an API Key

First, you need to sign up and get your API key from the Dashboard.

2. Make your first request

Let’s use the Address Normalization API as our first test. We will normalize a raw, messy address string.

curl -X POST "https://api.goodvat.com/v1/address/normalize" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "1600 pennsylvania ave nw washington dc 20500"
  }'

Expected Response

{
  "status": "success",
  "data": {
    "formatted_address": "1600 Pennsylvania Ave NW, Washington, DC 20500",
    "components": {
      "house_number": "1600",
      "road": "Pennsylvania Ave NW",
      "city": "Washington",
      "state": "DC",
      "postcode": "20500",
      "country": "US"
    }
  }
}

You are now ready to integrate GoodVat into your application! Check out our SDKs to find the right library for your stack.