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

Inputs and Outputs#

The table below shows the most common inputs and outputs for this endpoint.

For full details on the inputs see the Request Parameters and for a complete list of the outputs see the Response fields.

  • GET JSON
  • POST JSON

Inputs

Outputs

Request Level Parameters

id

t

Record Level Parameters

a1

a2

a3

a4

a5

a6

a7

a8

admarea

ctry

lat

loc

long

org

postal

reason

respondto

Service Level Response Fields

Version

TransmissionReference

TransmissionResults

Results

Message

Inputs

Outputs

Request Level Parameters

CustomerID

TransmissionReference

Record Level Parameters

AddressLine1

AddressLine2

AddressLine3

AddressLine4

AddressLine5

AddressLine6

AddressLine7

AddressLine8

AdministrativeArea

Country

Latitude

Locality

Longitude

Organization

PostalCode

Reason

RespondToEmail

Service Level Response Fields

Version

TransmissionReference

TransmissionResults

Results

Message

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

Inputs and Outputs#

The table below shows the most common inputs and outputs for this endpoint.

For full details on the inputs see the Request Parameters and for a complete list of the outputs see the Response fields.

  • GET JSON
  • POST JSON

Inputs

Outputs

Request Level Parameters

id

t

Record Level Parameters

ctry

mak

lat

long

reason

respondto

Service Level Response Fields

Version

TransmissionReference

TransmissionResults

Results

Message

Inputs

Outputs

Request Level Parameters

CustomerID

TransmissionReference

Record Level Parameters

Country

MelissaAddressKey

Latitude

Longitude

Reason

RespondToEmail

Service Level Response Fields

Version

TransmissionReference

TransmissionResults

Results

Message

Sample Code#