Address Standardization Tutorial
Overview
Address Standardize is a real-time solution for standardizing an address by splitting it down into multiple parts and append additional information.
Address Standardize URI
The Address Standardize URI accepts an address and returns that address broken down into parts.
Required Information
The Address Standardize URI requires you to have an Authorization Token. If you have not retrieved an Authorization Token yet, follow the Authorization Tutorial before continuing.
The Address Standardize URI, like all of the solution URIs, also requires you to have an API Key. If you do not know your API Key, contact support to retrieve it. The API Key should be provided in the request header with the header attribute: x-api-key
The Address Standardize URI must be used with a POST request, where the request payload contains the address you would like standardized.
Example
Request URL
The URL for the Address Standardize URI is: https://api.thedatagroup.com/{version}/sync/standardize/address, where {version} is the API Version you wish to use.
Request Headers
Header Attribute Header Value x-api-key {your api key} AuthorizationToken {your authorization token} Content-Type application/json
Header Attribute | Header Value |
---|---|
x-api-key | {your api key} |
AuthorizationToken | {your authorization token} |
Content-Type | application/json |
Request Payload
The request payload for the Address Standardize URI must contain the address_1 and the zipcode attributes.
{ "address_1": "425 S. Avalon Park BLVD", "zipcode": "32828" }
cURL Example
To query the Address Standardize URI, you can use one of the provided SDKs, a REST Client, or a simple cURL command. Below is an example of the cURL command for the example input information.
curl -X POST -H "Content-Type: application/json" -H "AuthorizationToken: {your_token}" -H "x-api-key: {your_key}" -H "Cache-Control: no-cache" -d '{ "address_1": "425 S. Avalon Park BLVD", "zipcode": "32828" }' "https://api.thedatagroup.com/v3/sync/standardize/address"
Response Payload
The response payload for the Address Standardize URI will contain the address from the request payload split up into multiple parts.
{ "street_number": "425", "street_name": "AVALON PARK SOUTH", "street_type": "BLVD", "city": "ORLANDO", "zipcode": "32828", "state": "FL" }