Addresses - Zamp

Only US addresses are currently supported.

Validate an Address

Request

POST /addresses

line1

string

required

Street address

line2

string

Additional address line

city

string

required

City name

state

string

required

2-letter state code

zip

string

required

ZIP code. Format: ##### or #####-####

country

string

default:"US"

Country code

curl -X POST https://api.zamp.com/addresses \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "line1": "120 SW 10TH AVE",
    "line2": null,
    "city": "TOPEKA",
    "state": "KS",
    "zip": "66612"
  }'

Response

A lookup is considered successful (status code 200) when the request meets requirements and there are no system failures. If the address is valid, validatedAddress is populated with the validated address and coordinates. An address is invalid (not found) when validatedAddress is null.

originalAddress

The original address passed in the request

validatedAddress

Returns the validated address, or null

{
  "originalAddress": {
    "line1": "120 SW 10TH AVE",
    "line2": null,
    "city": "TOPEKA",
    "state": "KS",
    "zip": "66612",
    "country": "US"
  },
  "validatedAddress": {
    "coordinates": [-95.67659, 39.046513],
    "line1": "120 SW 10th Ave",
    "line2": null,
    "city": "Topeka",
    "state": "KS",
    "zip": "66612-1226",
    "country": "US"
  }
}

{
  "originalAddress": {
    "line1": "999 NOWHERE RD",
    "line2": null,
    "city": "TOPEKA",
    "state": "KS",
    "zip": "66612",
    "country": "US"
  },
  "validatedAddress": null
}

When the address cannot be matched, the request still returns 200 with validatedAddress set to null:

"validatedAddress": null

CalculationsCalculate tax due on transactions in real-time.

curl -X POST https://api.zamp.com/addresses \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "line1": "120 SW 10TH AVE",
    "line2": null,
    "city": "TOPEKA",
    "state": "KS",
    "zip": "66612"
  }'

{
  "originalAddress": {
    "line1": "120 SW 10TH AVE",
    "line2": null,
    "city": "TOPEKA",
    "state": "KS",
    "zip": "66612",
    "country": "US"
  },
  "validatedAddress": {
    "coordinates": [-95.67659, 39.046513],
    "line1": "120 SW 10th Ave",
    "line2": null,
    "city": "Topeka",
    "state": "KS",
    "zip": "66612-1226",
    "country": "US"
  }
}

{
  "originalAddress": {
    "line1": "999 NOWHERE RD",
    "line2": null,
    "city": "TOPEKA",
    "state": "KS",
    "zip": "66612",
    "country": "US"
  },
  "validatedAddress": null
}

​Validate an Address

​Request

​Response

Validate an Address

Request

Response