Sign in

v1

latestOpenAPI 3.1.22026-08-0641130.2 KB
Add MAK

Add new MAKs

Use this POST endpoint to submit a request to add an unlisted address for review and the generation of an associated Melissa Address Key (MAK). This is part of our contribution pipeline to include user input and improve data accuracy.

To ensure your request can be processed, include the complete address details (e.g. address line 1, locality (city), administrative area (state), postal code (zip), country, and an explanation in the comments field (e.g., “New residential subdivision” or “Commercial building recently completed”). Submissions without adequate justification may be discarded.

Upon a successful request you will get an MS01 result code and a successful submission message.

All user contributions enter a queue and are evaluated by our team on a case-by-case basis.

Submitting a correction does not guarantee that it will be approved or integrated into the active dataset.

post/addMAK

Headers

Accept'application/json' | '*/*' required

Format of the response.

Content-Type'application/json' required

Format of the request.

Request body

CustomerIDstring required

Required. The License Key issued by Melissa.

TransmissionReferencestring

Value passed through unchanged to the response for identification or any other purpose.

AddressLine1string

A minimum address location for the contact.

AddressLine2string

The second address line.

AddressLine3string

The third address line.

AddressLine4string

The fourth address line.

AddressLine5string

The fifth address line.

AddressLine6string

The sixth address line.

AddressLine7string

The seventh address line.

AddressLine8string

The eighth address line.

AdministrativeAreastring

Administrative Area, Province, State. The most common geographic data element.

Countrystring

ISO2 code for the country.

Latitudestring

The latitude.

Localitystring

City, Locality, Municipality. The most common population center data element.

Longitudestring

The longitude.

Organizationstring

The organization name associated with the address record.

PostalCodestring

The ZIP Code.

Reasonstring

Any additional information you want to add about the change request.

RespondToEmailstring

The email address to receive updates about the change request.

Response

Successful response

Versionstring

The current service version number.

TransmissionResultsstring

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

TransmissionReferencestring

Serves as a unique request identifier.

Resultsstring

Comma delimited status, error codes, and change codes for the record. For more information, see Contribution Result Codes.

Messagestring

The response message for the request.