Check change of Canadian addresses

Request

Submit a bulk request to check change of Canadian addresses.

The service requires at least one of the following input combinations:

Set A - NameFirst, NameLast / NameFull / Company

Set B - AddressLine1

Set C - City, State / PostalCode

Headers

Acceptstringrequired

Format of the response.

Enum:"application/json""application/xml""*/*"

Example:*/*

Content-Typestringrequired

Format of the request.

Enum:"application/json""application/xml"

Body

required

Actionsstring

Selects which COA objects to be used in the request. For Canadian Change of Address Object, use CCOA.

Columnsstring

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

NameFirst
NameFull
NameLast
NameMiddle
NamePrefix
NameSuffix

GrpOriginal - Original Address Details

OriginalAddressLine1
OriginalAddressLine2
OriginalCity
OriginalCityAbbreviation
OriginalCountryCode
OriginalPlus4
OriginalPostalCode
OriginalPrivateMailbox
OriginalResults
OriginalState
OriginalStateName
OriginalSuite
OriginalUrbanization

GrpParsed - Parsed Address Details

AddressDeliveryInstallation
AddressHouseNumber
AddressLockBox
AddressPostDirection
AddressPreDirection
AddressPrivateMailboxName
AddressPrivateMailboxRange
AddressRouteService
AddressStreetName
AddressStreetSuffix
AddressSuiteName
AddressSuiteNumber

GrpStandardized - Standardized Address Details

StandardizedAddressLine1
StandardizedAddressLine2
StandardizedBaseMelissaAddressKey
StandardizedCarrierRoute
StandardizedCity
StandardizedCityAbbreviation
StandardizedCountryCode
StandardizedDeliveryIndicator
StandardizedDeliveryPointCheckDigit
StandardizedDeliveryPointCode
StandardizedMelissaAddressKey
StandardizedPlus4
StandardizedPostalCode
StandardizedPrivateMailbox
StandardizedResults
StandardizedState
StandardizedStateName
StandardizedSuite
StandardizedUrbanization

[COLUMN NAME ONLY] - These columns can only be requested by using their name.

DPVFootNotes
MoveReturnCode
Plus4
PrivateMailbox
Suite

CustomerIDstringrequired

Required. The License Key issued by Melissa.

ExecutionIDstring

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.

JobIDstring

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.

OptionSmartMoverListNamestring

Identifies the current list. It will be included in reports returned by SmartMover V3 after processing.

TransmissionReferencestring

Serves as a unique identifier for this set of records. This allows you to match a response to a request.

RecordsArray of objects, [ 1 .. 100 ] items

curl -i -X POST \
  https://smartmovercanada.melissadata.net/V3/WEB/SmartMover/doSmartMover \
  -H 'Accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{
    "Actions": "",
    "Columns": "",
    "CustomerID": "{REPLACE-WITH-YOUR-LICENSE-KEY}",
    "JobID": "001",
    "OptionSmartMoverListName": "",
    "TransmissionReference": "Test",
    "Records": [
      {
        "AddressLine1": "80 Wellington St.",
        "City": "Ottawa",
        "Company": "",
        "Country": "CA",
        "NameFull": "Prime Minister of Canada",
        "Plus4": "",
        "PostalCode": "K1P 5K9",
        "RecordID": "1",
        "State": "ON"
      }
    ]
  }'

Responses

Successful response

Body

Versionstring

The current service version number.

TransmissionReferencestring

A pass-through of the input TransmissionReference field.

TransmissionResultsstring

Lists error codes from any errors caused by the most recent request as a whole. For more information, see SmartMover Result Codes.

TotalRecordsstring

Total number of records.

RecordsArray of objects

This is the returned array of records.

Response

{
  "Records": {
    "AddressExtras": "",
    "AddressKey": "K1A0A2",
    "AddressLine1": "80 Wellington St",
    "AddressLine2": "",
    "AddressTypeCode": "1",
    "BaseMelissaAddressKey": "",
    "CarrierRoute": "",
    "City": "Ottawa",
    "CityAbbreviation": "Ottawa",
    "CompanyName": "",
    "CountryCode": "CA",
    "CountryName": "Canada",
    "DeliveryIndicator": "",
    "DeliveryPointCheckDigit": "",
    "DeliveryPointCode": "",
    "MelissaAddressKey": "8620912446",
    "MoveEffectiveDate": "",
    "MoveTypeCode": "",
    "PostalCode": "K1A 0A2",
    "RecordID": "1",
    "Results": "AC01,AS01",
    "State": "ON",
    "StateName": "Ontario",
    "Urbanization": ""
  },
  "TotalRecords": "1",
  "TransmissionReference": "Test",
  "TransmissionResults": "",
  "Version": "8.4.1.1130"
}