Validate an address

Validates a physical address using geocoding. Returns formatted address, coordinates, and normalized components.

POST /api/address/validate

Validate an address

cURL

curl --request POST \
  --url https://app.demand-iq.com/api/address/validate \
  --header 'Content-Type: application/json' \
  --cookie session= \
  --data '
{
  "address": "123 Main St",
  "city": "Phoenix",
  "country": "US",
  "state": "AZ",
  "zip": "85001"
}
'

200

{
  "valid": true,
  "formattedAddress": "<string>",
  "coordinates": {
    "lat": 123,
    "lng": 123
  },
  "normalized": {},
  "error": "<string>"
}

Authorizations

session · string · cookie · required

Session cookie obtained from POST /api/auth/login.

Body

application/json

address · string · required

Example:

"123 Main St"

city · string · required

Example:

"Phoenix"

country · string · required

ISO 3166-1 alpha-2 country code

Required string length: 2

Example:

"US"

state · string

Example:

"AZ"

zip · string

Example:

"85001"

Response

200

application/json

Validation result

valid · boolean

formattedAddress · string

coordinates · object

Show child attributes

normalized · object

error · string