Skip to content
  • Change GeoPoint
  • Data Retriever
  • Elected Officials
  • Global Address Verification
  • Global Email
  • Global Express Entry
  • Global IP
  • Global Name
  • Global Phone
  • LeadGen - Business
  • LeadGen - Consumer
  • LeadGen - Occupant
  • LeadGen - Property
  • Melissa Releases
  • People Business Search
  • Personator Consumer
  • Personator Identity
  • Personator Search
  • Property
  • Reverse GeoCoder
  • SmartMover CA
  • SmartMover US
  • SSN Name Match
  • Street Route
  • Token Server
  • US Business Coder
  • Usage

    • Add new MAKs

    Request

    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.

    Headers
    Acceptstringrequired

    Format of the response.

    Enum:"application/json""*/*"
    Example:application/json
    Content-Typestringrequired

    Format of the request.

    Value:"application/json"
    Bodyapplication/jsonrequired
    CustomerIDstringrequired

    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.

    curl -i -X POST \
  http://contribution.melissadata.net/V4/WEB/addMAK \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "CustomerID": "{REPLACE-WITH-YOUR-LICENSE-KEY}",
    "TransmissionReference": "Test",
    "AddressLine1": "22382 Avenida Empresa",
    "AddressLine2": "",
    "Locality": "Rancho Santa Margarita",
    "Country": "US",
    "Latitude": "33.637562",
    "Longitude": "-117.606887",
    "PostalCode": "92688",
    "Reason": "Add a MAK",
    "RespondToEmail": "youremail@melissadata.com",
    "AdministrativeArea": "CA"
  }'

    Responses

    Successful response

    Bodyapplication/json
    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.

    Response
    {
  "Version": "8.4.0.1026",
  "TransmissionReference": "Test",
  "TransmissionResults": "",
  "Results": "MS01",
  "Message": "Thank you for submitting your correction. All submissions will be reviewed and added. We cannot guarantee that all submissions will be reflected in our final products or when they will be added. Usual turn-around time is several months."
}