Contribution Quickstart#

Introduction#

The Melissa Contribution Cloud API allows customers to submit data corrections and additions to improve Melissa reference data quality.

Using this service, customers can:

  • Submit corrected GeoPoints by providing the MAK and updated latitude and/or longitude values

  • Submit new addresses that are not currently found in the Melissa database

After a contribution is submitted, it is reviewed by our team to verify the accuracy of the proposed correction. If the submission is confirmed to be valid, the update will be incorporated into the Melissa database. Please note that the review and update process may take several months to complete.

New to Melissa Cloud APIs?#

We highly recommend first time users of our Cloud APIs to review our Using Melissa Cloud APIs section. It will cover critical topics like:

System Requirements#

  • SSL/TLS 1.2+

Getting Started#

What Can I Do?#

Add a new MAK#

You can submit a request to add an unlisted address for review and the generation of an associated Melissa Address Key (MAK).

Endpoint#

/V4/WEB/addMAK

Click here to go to the full endpoint documentation.

Try it Now#
  • GET JSON
  • POST JSON
curl -X GET "https://contribution.melissadata.net/V4/WEB/addMAK?\
&id={{customerId}}\
&t=Test\
&a1=22382%20Avenida%20Empresa\
&a2=\
&admarea=CA\
&ctry=US\
&lat=33%2E637562\
&loc=Ranch%20Santa%20Margarita\
&long=-117%2E606887\
&postal=92688\
&reason=Add%20a%20MAK\
&respondto=youremail%40melissadata%2Ecom" \
-H "Content-Type:application/json" \
-H "Accept:application/json"
curl -X POST "https://contribution.melissadata.net/V4/WEB/addMAK" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
    "CustomerID": {{customerId}},
    "TransmissionReference": "Test",
    "AddressLine1": "22382 Avenida Empresa",
    "AddressLine2": "",
    "AdministrativeArea": "CA",
    "Country": "US",
    "Latitude": "33.637562",
    "Locality": "Rancho Santa Margarita",
    "Longitude": "-117.606887",
    "PostalCode": "92688",
    "Reason": "Add a MAK",
    "RespondToEmail": "youremail@melissadata.com"
    }'

Change a GeoPoint#

You can submit a request to correct a GeoPoint.

Endpoint#

/V4/WEB/changeGeoPoint

Click here to go to the full endpoint documentation.

Try it Now#
  • GET JSON
  • POST JSON
curl -X GET "https://contribution.melissadata.net/V4/WEB/changeGeoPoint?\
&id={{customerId}}\
&t=Test\
&lat=33%2E637562\
&long=-117%2E606887\
&mak=8008006245\
&reason=GeoPoint%20Change%20needed\
&respondto=youremail%40melissadata%2Ecom" \
-H "Content-Type:application/json" \
-H "Accept:application/json"
curl -X POST "https://contribution.melissadata.net/V4/WEB/changeGeoPoint" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
    "CustomerID": {{customerId}},
    "TransmissionReference": "Test",
    "Latitude": "33.637562",
    "Longitude": "-117.606887",
    "MelissaAddressKey": "8008006245",
    "Reason": "GeoPoint Change needed",
    "RespondToEmail": "youremail@melissadata.com"
    }'

Sample Code#