Quickstart#
Introduction#
Welcome to the Melissa SmartMover Cloud Service. Contact data will deteriorate over time as people and businesses move around. SmartMover will allow you to keep that data up to date, both maintaining and confirming accuracy. The SmartMover Cloud Service is able to validate and standardize addresses, detect moves, and provide an updated address for an individual or business. SmartMover is available for both the US and Canada using data from the USPS and Canada Post respectively
You can use SmartMover to:
Keep contact addresses from the US and Canada up to date.
Standardize and validate addresses.
System Requirements#
SSL/TLS 1.2+
Getting Started - What Can I Do?#
Check a US Address#
Smart Mover can validate and standardize US addresses, detect moves, and provide an updated address for an individual or business.
Endpoint#
US: https://smartmover.melissadata.net/V3/WEB/SmartMover
Click here to go to the full endpoint documentation.
Try It Now#
curl -X GET "https://smartmover.melissadata.net/V3/WEB/SmartMover/doSmartMover?\
&id={{customerId}}\
&pafid={{pafId}}\
&a1=22382%20Avenida%20Empresa\
&city=Rancho%20Santa%20Margarita\
&comp=Melissa\
&ctry=US\
&full=Ray%20Melissa\
&postal=92688\
&state=CA" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
curl -X POST "https://smartmover.melissadata.net/V3/WEB/SmartMover/doSmartMover" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"Actions": "NCOA",
"Columns": "",
"CustomerID": "{{customerId}}",
"ExecutionID": "Batch_1",
"Format": "json",
"JobID": "",
"Options": "",
"OptSmartMoverListName": "",
"PAFId": "{{pafId}}",
"Records":
[{
"AddressLine1": "22382 Avenida Empresa",
"AddressLine2": "",
"City": "Rancho Santa Margarita",
"Company": "Melissa",
"Country": "US",
"NameFirst": "",
"NameFull": "Ray Melissa",
"NameLast": "",
"NameMiddle": "",
"NamePrefix": "",
"NameSuffix": "",
"Plus4": "",
"PostalCode": "92688",
"PrivateMailbox": "",
"RecordID": "1",
"State": "CA",
"Suite": "",
"Urbanization": ""
}],
"TransmissionReference": ""
}'
curl -X GET "https://smartmover.melissadata.net/V3/WEB/SmartMover/doSmartMover?\
&id={{customerId}}\
&pafid={{pafId}}\
&a1=22382%20Avenida%20Empresa\
&city=Rancho%20Santa%20Margarita\
&comp=Melissa\
&ctry=US\
&full=Ray%20Melissa\
&postal=92688\
&state=CA" \
-H "Content-Type: application/xml" \
-H "Accept: application/xml"
curl -X POST "https://smartmover.melissadata.net/V3/WEB/SmartMover/doSmartMover" \
-H "Content-Type: application/xml" \
-H "Accept: application/xml" \
-d '<Request>
<Actions></Actions>
<Columns></Columns>
<CustomerID>{{customerId}}</CustomerID>
<JobID></JobID>
<Options></Options>
<OptSmartMoverListName></OptSmartMoverListName>
<PAFId>{{pafId}}</PAFId>
<Records>
<RequestRecord>
<AddressLine1>22382 Avenida Empresa</AddressLine1>
<AddressLine2></AddressLine2>
<City>Rancho Santa Margarita</City>
<Company></Company>
<Country></Country>
<NameFirst></NameFirst>
<NameFull></NameFull>
<NameLast></NameLast>
<NameMiddle></NameMiddle>
<NamePrefix></NamePrefix>
<NameSuffix></NameSuffix>
<Plus4></Plus4>
<PostalCode>92688</PostalCode>
<PrivateMailbox></PrivateMailbox>
<RecordID></RecordID>
<State>CA</State>
<Suite></Suite>
<Urbanization></Urbanization>
</RequestRecord>
</Records>
<TransmissionReference></TransmissionReference>
</Request>'
Check a Canadian Address#
Smart Mover can validate and standardize Canadian addresses, detect moves, and provide an updated address for an individual or business.
Endpoint#
Canada: https://smartmovercanada.melissadata.net/V3/WEB/SmartMover
Click here to go to the full endpoint documentation.
Try It Now#
curl -X GET "https://smartmovercanada.melissadata.net/V3/WEB/SmartMover/doSmartMover?\
&act=\
&cols=\
&format=json\
&id={{customerId}}\
&jobid=001\
&list=\
&opt=\
&t=\
&a1=80%20Wellington%20St%2E\
&city=Ottawa\
&comp=\
&ctry=CA\
&full=Prime%20Minister%20of%20Canada\
&plus4=\
&postal=K1P%205K9\
&state=ON" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
curl -X POST "https://smartmovercanada.melissadata.net/V3/WEB/SmartMover/doSmartMover" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"Actions": "",
"Columns": "",
"CustomerID": "{{customerId}}",
"Format": "json",
"JobID": "001",
"Options": "",
"OptSmartMoverListName": "",
"Records":
[{
"AddressLine1": "80 Wellington St.",
"City": "Ottawa",
"Company": "",
"Country": "CA",
"NameFull": "Prime Minister of Canada",
"Plus4": "",
"PostalCode": "K1P 5K9",
"RecordID": "1",
"State": "ON"
}],
"TransmissionReference": ""
}'
curl -X GET "https://smartmovercanada.melissadata.net/V3/WEB/SmartMover/doSmartMover?\
&act=\
&cols=\
&format=xml\
&id={{customerId}}\
&jobid=001\
&list=\
&opt=\
&t=\
&a1=80%20Wellington%20St%2E\
&city=Ottawa\
&comp=\
&ctry=CA\
&full=Prime%20Minister%20of%20Canada\
&plus4=\
&postal=K1P%205K9\
&state=ON" \
-H "Content-Type: application/xml" \
-H "Accept: application/xml"
curl -X POST "https://smartmovercanada.melissadata.net/V3/WEB/SmartMover/doSmartMover" \
-H "Content-Type: application/xml" \
-H "Accept: application/xml" \
-d '<Request>
<Actions></Actions>
<Columns></Columns>
<CustomerID>{{customerId}}</CustomerID>
<Format>xml</Format>
<JobID>001</JobID>
<Options>GrpAll</Options>
<OptSmartMoverListName></OptSmartMoverListName>
<Records>
<RequestRecord>
<AddressLine1>80 Wellington St.</AddressLine1>
<City>Ottawa</City>
<Company></Company>
<Country>CA</Country>
<NameFull>Prime Minister of Canada</NameFull>
<Plus4></Plus4>
<PostalCode>K1P 5K9</PostalCode>
<RecordID>1</RecordID>
<State>ON</State>
</RequestRecord>
</Records>
<TransmissionReference></TransmissionReference>
</Request>'
Sample Code#
Language |
Repository |
|---|---|
C# .NET |
|
Python3 |
|
Postman Collection |
