v1

latestOpenAPI 3.1.22026-08-0641130.2 KB
Add MAK

Add a new MAK

Use this GET 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.

get/addMAK

Query parameters

tstring

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

{"stackTrail":"components:parameters:LicenseKeyParam:schema","oasType":"schema","type":"unknown"}

Required. The License Key issued by Melissa.

a1string required

A minimum address location for the contact.

a2string

The second address line.

a3string

The third address line.

a4string

The fourth address line.

a5string

The fifth address line.

a6string

The sixth address line.

a7string

The seventh address line.

a8string

The eighth address line.

admareastring required

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

ctrystring required

ISO2 code for the country.

latnumber required

The latitude.

locstring required

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

longnumber required

The longitude.

orgstring

The organization name associated with the address record.

postalstring required

The ZIP Code.

reasonstring

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

respondtostring

The email address to receive updates about the change request.

Headers

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

Format of the response.

Content-Type'application/json' required

Format of the 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.

All 4 operations