Addresses

Only US addresses are currently supported.

Validate an Address

Request

POST /addresses

string

required

Street address

string

Additional address line

string

required

City name

string

required

2-letter state code

string

required

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

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.

The original address passed in the request

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
}

Home

Core Concepts

Workflow Playbooks

API Reference

Integrations

Validate an Address

Request

Response

​Validate an Address

​Request

​Response

Validate an Address

Request

Response