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 a new MAK

    Request

    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.

    Query
    tstring

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

    Example:t=Test
    idstring, (password)required

    Required. The License Key issued by Melissa.

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

    A minimum address location for the contact.

    Example:a1=22382 Avenida Empresa
    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.

    admareastringrequired

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

    Example:admarea=CA
    ctrystringrequired

    ISO2 code for the country.

    Example:ctry=US
    latnumberrequired

    The latitude.

    Example:lat=33.637562
    locstringrequired

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

    Example:loc=Rancho Santa Margarita
    longnumberrequired

    The longitude.

    Example:long=-117.606887
    orgstring

    The organization name associated with the address record.

    postalstringrequired

    The ZIP Code.

    Example:postal=92688
    reasonstring

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

    Example:reason=Add a MAK
    respondtostring

    The email address to receive updates about the change request.

    Example:respondto=youremail@melissadata.com
    Headers
    Acceptstringrequired

    Format of the response.

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

    Format of the request.

    Value:"application/json"
    curl -i -X GET \
  'http://contribution.melissadata.net/V4/WEB/addMAK?id=%7BREPLACE-WITH-YOUR-LICENSE-KEY%7D&a1=22382%20Avenida%20Empresa&admarea=CA&ctry=US&lat=33.637562&loc=Rancho%20Santa%20Margarita&long=-117.606887&postal=92688' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json'

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