Change of Canadian Address Detection

Use Canadian Address Detection endpoint to check a move with a name and address in Canada, or check if a business has changed locations.

Operations

Check a move in Canada

Request

Send a GET request to check a move in Canada.

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

Set A - first, last / full / comp

Set B - a1

Set C - city, state / postal

Query

actstring

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

colsstring

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

formatstring

The desired format of the response.

Enum:"json""xml"

Example:format=json

idany, (password)required

Required. The License Key issued by Melissa.

Example:id={REPLACE-WITH-YOUR-LICENSE-KEY}

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.

Example:jobid=001

liststring

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

tstring

Transmission Reference - Serves as a unique identifier for this set of records.

Example:t=Test

a1stringrequired

A minimum address location for the name / company contact.

Example:a1=80 Wellington St.

a2string

The second address line.

citystringrequired

The city name.

Example:city=Ottawa

compstring

The name of the business.

ctrystring

The country code. SmartMover CA can only update addresses within Canada.

Example:ctry=CA

firststring

The parsed first name of an individual.

fullstringrequired

The full name of an individual. Required unless parsed name inputs are used.

Example:full=Prime Minister of Canada

laststring

The parsed last name of an individual.

middlestring

The parsed middle name of an individual.

nameprestring

The title or honorific prefix of the name. E.g. Mr, Miss, Dr.

namesuffixstring

The generational or professional suffix of the name. E.g. Jr, IV, Ph.D..

plus4string

The last four digits of a ZIP+4.

pmbstring

The private mailbox number, if this address is a box in a private mailbox service.

postalstringrequired

The five-digit ZIP Code, the first five digits of a ZIP+4, or a full nine-digit ZIP+4.

Example:postal=K1P 5K9

statestringrequired

The state name.

Example:state=ON

stestring

The suite number.

Acceptstringrequired

Format of the response.

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

Example:*/*

Content-Typestringrequired

Format of the request.

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

curl -i -X GET \
  'https://smartmovercanada.melissadata.net/V3/WEB/SmartMover/doSmartMover?id=%7BREPLACE-WITH-YOUR-LICENSE-KEY%7D&a1=80%20Wellington%20St.&city=Ottawa&full=Prime%20Minister%20of%20Canada&postal=K1P%205K9&state=ON' \
  -H 'Accept: */*' \
  -H 'Content-Type: application/json'

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"
}