# Check change of addresses An HTTPS POST is issued with the "ContentType" header specifying the format of the request and the "Accept" header specifying the format of the response. Endpoint: POST /doSmartMover ## Request fields (application/json): - `Actions` (string) Selects which COA objects to be used in the request. For US Change of Address Object, use NCOA. - `Columns` (string) [Columns](https://docs.melissa.com/cloud-api/smartmover/smartmover-reference-guide.html#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 - `CustomerID` (string, required) The [License Key](https://docs.melissa.com/melissa/license/license-information.html) issued by Melissa. - `ExecutionID` (string) 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. - `Format` (string) The desired format of the response. Enum: "json", "xml" - `JobID` (string) 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` (string) Options - Specify which options to use for the selected action. List of options in : format. Multiple options are delimited with a ,. For example: OptionName:Parameter,OptionName:Parameter. - ListOwnerFreqProcessing: - This option accepts a value from 1 to 52. This is the number of times per year the current mailing list is used for mailing. E.g., for monthly use 12, for quarterly use 4. - ProcessingType: - The processing type. - `OptionSmartMoverListName` (string) Identifies the current list. It will be included in reports returned by SmartMover V3 after processing. - `PAFId` (string) 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. - `TransmissionReference` (string) Serves as a unique identifier for this set of records. This allows you to match a response to a request. - `Records` (array) - `Records.AddressLine1` (string) A minimum address location for the name / company contact. - `Records.AddressLine2` (string) The second address line. - `Records.City` (string) The city name. - `Records.Company` (string) The name of the business. - `Records.Country` (string) The country code. SmartMover US can only update addresses within the United States. - `Records.NameFirst` (string) The parsed first name of an individual. - `Records.NameFull` (string) The full name of an individual. Required unless parsed name inputs are used. - `Records.NameLast` (string) The parsed last name of an individual. - `Records.NameMiddle` (string) The parsed middle name of an individual. - `Records.NamePrefix` (string) The title or honorific prefix of the name. E.g. Mr, Miss, Dr. - `Records.NameSuffix` (string) The generational or professional suffix of the name. E.g. Jr, IV, Ph.D.. - `Records.Plus4` (string) The last four digits of a ZIP+4. - `Records.PostalCode` (string) The five-digit ZIP Code, the first five digits of a ZIP+4, or a full nine-digit ZIP+4. - `Records.PrivateMailbox` (string) The private mailbox number, if this address is a box in a private mailbox service. - `Records.RecordID` (string) This is a string value containing a unique identifier for the current record. Use this to match the record submitted with the record returned. It will return what is inputted. - `Records.State` (string) The state name. - `Records.Suite` (string) The suite number. - `Records.Urbanization` (string) Only used for addresses in Puerto Rico. This is used to break ties between similar addresses in the same Postal Code. ## Response 200 fields (application/json): - `Version` (string) The current service version number. - `TransmissionReference` (string) A pass-through of the input TransmissionReference field. - `TransmissionResults` (string) Lists error codes from any errors caused by the most recent request as a whole. For more information, see [SmartMover Result Codes](https://docs.melissa.com/cloud-api/smartmover/result-codes.html). - `TotalRecords` (string) Total number of records. - `CASSReportLink` (string) CASS summary report link. - `NCOAReportLink` (string) NCOA summary report link. - `Records` (array) This is the returned array of records. - `Records.AddressExtras` (string) Returns any text that could not be identified as belonging to any of the other address fields. - `Records.AddressKey` (string) Returns a unique key for the current address. - `Records.AddressLine1` (string) Address Line 1. - `Records.AddressLine2` (string) Address Line 2. - `Records.AddressTypeCode` (string) Code specifying the type of address. - `Records.BaseMelissaAddressKey` (string) A unique key assigned to the base address of a complex with apartments or suites. - `Records.CarrierRoute` (string) Carrier route code, with the first character being alphabetic and the following three characters being numeric. The alphabetic letter indicates the type of delivery associated with the address. - `Records.City` (string) City name. If the city name is more than 28 characters long, CityAbbreviation will contain the official USPS abbreviation for the city. - `Records.CityAbbreviation` (string) City abbreviation. If the city name is more than 28 characters long, this will contain the official USPS abbreviation for the city. - `Records.CompanyName` (string) Name of the business. - `Records.CountryCode` (string) The standard code of the country. Currently only Canada and the United States are supported. - `Records.CountryName` (string) The full country name. Currently only Canada and the United States are supported. - `Records.DeliveryIndicator` (string) The RBDI Indicator code based on the address. - `Records.DeliveryPointCheckDigit` (string) Contains the 12th digit of the POSTNET barcode. - `Records.DeliveryPointCode` (string) Contains the 10th and 11th digits of the POSTNET barcode, usually the last two digits of the street number. - `Records.MelissaAddressKey` (string) (MAK) A unique key assigned to an address record. - `Records.MoveEffectiveDate` (string) US Only. Returns the effective date of the move in the format “YYYYMM”. - `Records.MoveTypeCode` (string) Specifies the type of address record matched. - `Records.PostalCode` (string) Postal Code. - `Records.RecordID` (string) Position of the record in the response array. - `Records.Results` (string) Returns record specific result codes. For more information, see [SmartMover Result Codes](https://docs.melissa.com/cloud-api/smartmover/result-codes.html). - `Records.State` (string) Standard two-letter abbreviation of the state. - `Records.StateName` (string) Full name of the state. - `Records.Urbanization` (string) Returns the value passed to the Urbanization field in the request. Only used for addresses in Puerto Rico. This is used to break ties between similar addresses in the same Postal Code. - `Records.NameFirst` (string) Returns the first name as submitted to the NameFirst field in the request. - `Records.NameFull` (string) Returns the full name as submitted to the NameFull field in the request. - `Records.NameLast` (string) Returns the last name as submitted to the NameLast field in the request. - `Records.NameMiddle` (string) Returns the middle name as submitted to the NameMiddle field in the request. - `Records.NamePrefix` (string) Returns the name prefix as submitted to the NamePrefix field in the request. - `Records.NameSuffix` (string) Returns the name suffix as submitted to the NameSuffix field in the request. - `Records.OriginalAddressLine1` (string) Returns the original address line 1 exactly as submitted in the request. - `Records.OriginalAddressLine2` (string) Returns the original address line 2 exactly as submitted in the request. - `Records.OriginalCity` (string) Returns the original city exactly as submitted in the request. - `Records.OriginalCityAbbreviation` (string) Returns the original country abbreviation exactly as submitted in the request. - `Records.OriginalCountryCode` (string) Returns the original country code exactly as submitted in the request. - `Records.OriginalPlus4` (string) Returns the original Plus + 4 exactly as submitted in the request. - `Records.OriginalPostalCode` (string) Returns the original postal code exactly as submitted in the request. - `Records.OriginalPrivateMailbox` (string) Returns the original private mailbox exactly as submitted in the request. - `Records.OriginalResults` (string) Returns the original results exactly as submitted in the request. - `Records.OriginalState` (string) Returns the original state exactly as submitted in the request. - `Records.OriginalStateName` (string) Returns the original state name exactly as submitted in the request. - `Records.OriginalSuite` (string) Returns the original suite exactly as submitted in the request. - `Records.OriginalUrbanization` (string) Returns the original urbanization exactly as submitted in the request. - `Records.AddressDeliveryInstallation` (string) Canada Only. Returns the parsed delivery installation of the address. - `Records.AddressHouseNumber` (string) Returns the parsed numeric portion of the street address. - `Records.AddressLockBox` (string) Returns the parsed lockbox. - `Records.AddressPostDirection` (string) Returns the parsed directional abbreviation that comes after the street name. For example, “Park Ave South” would return “S”. - `Records.AddressPreDirection` (string) Returns the parsed directional abbreviation that comes before the street name. For example, “100 North Main Street” would return “N”. - `Records.AddressPrivateMailboxName` (string) Returns the parsed non-numeric portion of a private mailbox number. Either “#” or “PMB”. - `Records.AddressPrivateMailboxRange` (string) Returns the parsed numeric portion of an address if it is located at a Commercial Mail Receiving Agency (CMRA). - `Records.AddressRouteService` (string) Returns the parsed route service. - `Records.AddressStreetName` (string) Returns the parsed name portion of the street address. This excludes the street number, suffix, and any directional. - `Records.AddressStreetSuffix` (string) Returns the parsed street suffix. E.g. “Rd”, “St”, or “Blvd”. - `Records.AddressSuiteName` (string) Returns the parsed standardized text from the suite. E.g. “STE” or “Unit”. - `Records.AddressSuiteNumber` (string) Returns the parsed numeric portion of the suite. - `Records.StandardizedAddressLine1` (string) Returns the standardized address line 1 using USPS addressing standards. - `Records.StandardizedAddressLine2` (string) Returns the standardized address line 2 using USPS addressing standards. - `Records.StandardizedBaseMelissaAddressKey` (string) Returns the Base Melissa Address Key of the standardized address. - `Records.StandardizedCarrierRoute` (string) Returns the standardized carrier route using USPS addressing standards. - `Records.StandardizedCity` (string) Returns the standardized city using USPS addressing standards. - `Records.StandardizedCityAbbreviation` (string) Returns the standardized city abbreviation using USPS addressing standards. - `Records.StandardizedCountryCode` (string) Returns the standardized country code using USPS addressing standards. - `Records.StandardizedDeliveryIndicator` (string) Returns the standardized delivery indicator using USPS addressing standards. - `Records.StandardizedDeliveryPointCheckDigit` (string) Returns the standardized delivery point check digit using USPS addressing standards. - `Records.StandardizedDeliveryPointCode` (string) Returns the standardized delivery point code using USPS addressing standards. - `Records.StandardizedMelissaAddressKey` (string) Returns the Melissa Address Key of the standardized address. - `Records.StandardizedPlus4` (string) Returns the standardized Plus + 4 using USPS addressing standards. - `Records.StandardizedPostalCode` (string) Returns the standardized postal code using USPS addressing standards. - `Records.StandardizedPrivateMailbox` (string) Returns the standardized private mailbox using USPS addressing standards. - `Records.StandardizedResults` (string) Returns the results of the standardized address. - `Records.StandardizedState` (string) Returns the standardized state using USPS addressing standards. - `Records.StandardizedStateName` (string) Returns the standardized state name using USPS addressing standards. - `Records.StandardizedSuite` (string) Returns the standardized suite using USPS addressing standards. - `Records.StandardizedUrbanization` (string) Returns the standardized urbanization using USPS addressing standards. - `Records.DPVFootNotes` (string) Indicates the level of matching between the current address and the USPS's DPV database. This footnote may be up to six characters long. For a list of codes, see SmartMover V3 Product Codes. - `Records.MoveReturnCode` (string) Code indicating the level of matching between the record and the NCOA Link database. For a list of codes, see Record Level Product Codes. - `Records.Plus4` (string) The last four digits of the ZIP + 4. - `Records.PrivateMailbox` (string) If the address is a private mailbox service the number will be returned here. - `Records.Suite` (string) Address suite. ## Response 400 fields (application/json): - `type` (string) The type of error that occurred. - `title` (string) A short summary of the error. - `status` (integer) The HTTP status code for the error. - `errors` (object) - `errors.$.` (array) A detailed message about the error. - `traceId` (string) A unique identifier for the request, useful for debugging.