Submit a bulk request to check change of US addresses.
The following are the possible minimum input requirements:
First and Last Name, Full Name, or Company
Address Only
City and State, ZIP Code, or AddressLastLine
Selects which COA objects to be used in the request. For US Change of Address Object, use NCOA.
Columns - The column names or groups to be output.
Entering the column name will return the column. Specifying a group name will return all columns in the group.
Delimit multiple columns with a ,.
For example: ColumnName,ColumnName.
Columns:
GrpName - Name Details
NameFirstNameFullNameLastNameMiddleNamePrefixNameSuffix
GrpOriginal - Original Address Details
OriginalAddressLine1OriginalAddressLine2OriginalCityOriginalCityAbbreviationOriginalCountryCodeOriginalPlus4OriginalPostalCodeOriginalPrivateMailboxOriginalResultsOriginalStateOriginalStateNameOriginalSuiteOriginalUrbanization
GrpParsed - Parsed Address Details
AddressDeliveryInstallationAddressHouseNumberAddressLockBoxAddressPostDirectionAddressPreDirectionAddressPrivateMailboxNameAddressPrivateMailboxRangeAddressRouteServiceAddressStreetNameAddressStreetSuffixAddressSuiteNameAddressSuiteNumber
GrpStandardized - Standardized Address Details
StandardizedAddressLine1StandardizedAddressLine2StandardizedBaseMelissaAddressKeyStandardizedCarrierRouteStandardizedCityStandardizedCityAbbreviationStandardizedCountryCodeStandardizedDeliveryIndicatorStandardizedDeliveryPointCheckDigitStandardizedDeliveryPointCodeStandardizedMelissaAddressKeyStandardizedPlus4StandardizedPostalCodeStandardizedPrivateMailboxStandardizedResultsStandardizedStateStandardizedStateNameStandardizedSuiteStandardizedUrbanization
[COLUMN NAME ONLY] - These columns can only be requested by using their name.
DPVFootNotesMoveReturnCodePlus4PrivateMailboxSuite
Required. The License Key issued by Melissa.
In rare situations you may run into a situation where a request will be time-out by a client but finished on the server. The client then resends the same request but the server believes it is another request. So, that can result in the same record counting twice on the NCOA and CCOA report. To account for that possibility, we have the Execution ID input. We will take a hash of the input and if the hash of the current input is identical to the previous input with the same ExecutionID, we will consider it a duplicate and not count it towards the report. Specify different values for different threads. Default value is 0 if not set.
This value will identify to the service which records belong to the same list for the purposes of the NCOA and CCOA report. All records from the same list should have the same JobID. This is NOT a database unique key, please use the RecordID field for that.
Options - Specify which options to use for the selected action. List of options in <OptionName>:<Parameter> format. Multiple options are delimited with a ,.
For example: OptionName:Parameter,OptionName:Parameter.
ListOwnerFreqProcessing:< [1 - 52] >- This option accepts a value from1to52. This is the number of times per year the current mailing list is used for mailing. E.g., for monthly use12, for quarterly use4.ProcessingType:< Business | Individual | IndividualAndBusiness | Residential | Standard >- The processing type.
Identifies the current list. It will be included in reports returned by SmartMover V3 after processing.
Only applies for Broker accounts and not to CCOA. For Smartmover Brokers with their own set of end users, use the PAF ID to identify which end user this record belongs to.
Serves as a unique identifier for this set of records. This allows you to match a response to a request.
- National Change of Address (NCOA)https://smartmover.melissadata.net/V3/WEB/SmartMover/doSmartMover
curl -i -X POST \
https://smartmover.melissadata.net/V3/WEB/SmartMover/doSmartMover \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"Actions": "NCOA",
"Columns": "",
"CustomerID": "{REPLACE-WITH-YOUR-LICENSE-KEY}",
"ExecutionID": "Batch_1",
"JobID": "",
"Options": "",
"OptionSmartMoverListName": "",
"PAFId": "",
"TransmissionReference": "Test",
"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": ""
}
]
}'Successful response
Lists error codes from any errors caused by the most recent request as a whole. For more information, see SmartMover Result Codes.
{ "CASSReportLink": "JobId required to generate summary report links...", "NCOAReportLink": "JobId required to generate summary report links...", "Records": { "AddressExtras": "", "AddressKey": "92688211282", "AddressLine1": "22382 Avenida Empresa", "AddressLine2": "", "AddressTypeCode": "S", "BaseMelissaAddressKey": "", "CarrierRoute": "C057", "City": "Rancho Santa Margarita", "CityAbbreviation": "Rcho Sta Marg", "CompanyName": "Melissa", "CountryCode": "US", "CountryName": "United States", "DeliveryIndicator": "B", "DeliveryPointCheckDigit": "1", "DeliveryPointCode": "82", "MelissaAddressKey": "8008006245", "MoveEffectiveDate": "", "MoveTypeCode": "", "PostalCode": "92688-2112", "RecordID": "1", "Results": "AS01,CS02", "State": "CA", "StateName": "California", "Urbanization": "" }, "TotalRecords": "1", "TransmissionReference": "Test", "TransmissionResults": "", "Version": "7.4.1.4198" }