Reference Guide

Introduction

The Melissa Contribution Cloud API allows you to submit corrections for data in Melissa products.

This includes:

• Specify problem GeoPoints using Melissa Address Keys (MAKs).

• Submit latitude and longitude corrections.

• Provide an email for correction notifications.

• Submit additional comments about the problem MAK.

CORS Handling - Header Changes

The Access-Control response headers for some requests will change by December 2025.

To read more about this change, please see the advisory.

Base URL

http://contribution.melissadata.net

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:

• Licensing

• Rate Limiting

• Datacenter and IP Information

• Protocols and Usage

Endpoints

/V4/WEB/addMAK

Use this endpoint to submit a request to add a new Melissa Address Key (MAK).

Try it Now

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

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

Request Parameters

• GET JSON
• POST JSON

Code	Description
Request Level Parameters
id	Required. The License Key issued by Melissa.
t	Value passed through unchanged to the response for identification or any other purpose.
Record Level Parameters
a1	A minimum address location for the contact.
a2	The second address line.
a3	The third address line.
a4	The fourth address line.
a5	The fifth address line.
a6	The sixth address line.
a7	The seventh address line.
a8	The eighth address line.
admarea	Administrative Area, Province, State. The most common geographic data element.
ctry	ISO2 code for the country.
lat	The latitude.
loc	City, Locality, Municipality. The most common population center data element.
long	The longitude.
org	The organization name associated with the address record.
postal	The ZIP Code.
reason	Any additional information you want to add about the change request.
respondto	The email address to receive updates about the change request.

Code	Description
Request Level Parameters
CustomerID	Required. The License Key issued by Melissa.
TransmissionReference	Value passed through unchanged to the response for identification or any other purpose.
Record Level Parameters
AddressLine1	A minimum address location for the contact.
AddressLine2	The second address line.
AddressLine3	The third address line.
AddressLine4	The fourth address line.
AddressLine5	The fifth address line.
AddressLine6	The sixth address line.
AddressLine7	The seventh address line.
AddressLine8	The eighth address line.
AdministrativeArea	Administrative Area, Province, State. The most common geographic data element.
Country	ISO2 code for the country.
Latitude	The latitude.
Locality	City, Locality, Municipality. The most common population center data element.
Longitude	The longitude.
Organization	The organization name associated with the address record.
PostalCode	The ZIP Code.
Reason	Any additional information you want to add about the change request.
RespondToEmail	The email address to receive updates about the change request.

Headers

• GET JSON
• POST JSON

 Content-Type: application/json
 Accept: application/json

 Content-Type: application/json
 Accept: application/json

Response

• GET JSON
• POST JSON

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

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

/V4/WEB/addMIK

Use this endpoint to submit a request to add a new Melissa Identity Address Key (MIK).

Try it Now

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

• POST JSON

curl -X POST "https://contribution.melissadata.net/V4/WEB/addMIK" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
    "CustomerID": {{customerId}},
    "TransmissionReference": "Test",
    "Add":
    [{
       "Key": "AddressLine1",
       "Value": "22382 Avenida Empresa"
    },
    {
       "Key": "City",
       "Value": "Rancho Santa Margarita"
    },
    {
       "Key": "State",
       "Value": "CA"
    },
    {
       "Key": "Country",
       "Value": "US"
    },
    {
       "Key": "Latitude",
       "Value": "33.637562"
    },
    {
       "Key": "Longitude",
       "Value": "-117.606887"
    }],
    "Reason": "Add a MIK",
    "RespondToEmail": "youremail@melissadata.com"
    }'

Request Parameters

• POST JSON

Code	Description
Request Level Parameters
CustomerID	Required. The License Key issued by Melissa.
TransmissionReference	Value passed through unchanged to the response for identification or any other purpose.
Record Level Parameters
Add	A list of key/value pairs containing new values to be added. Code Description Key The name of the field for data set by the associated value. Value The data for a field set by the associated key.
Reason	Any additional information you want to add about the change request.
RespondToEmail	The email address to receive updates about the change request.
Key Field Values (For Add Parameter)
AddressLine1	A minimum address location for the contact.
AddressLine2	The second address line.
City	The city name.
Country	ISO2 code for the country.
Latitude	The latitude.
Longitude	The longitude.
State	The state name.
Suite	The suite number.
Urbanization	Only used for addresses in Puerto Rico. This is used to break ties between similar addresses in the same Postal Code.

Headers

• POST JSON

 Content-Type: application/json
 Accept: application/json

Response

• POST JSON

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

/V4/WEB/changeGeoPoint

Use this endpoint to submit problem GeoPoints with comments and corrections.

Try It Now

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

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

Request Parameters

• GET JSON
• POST JSON

Code	Description
Request Level Parameters
id	Required. The License Key issued by Melissa.
t	Value passed through unchanged to the response for identification or any other purpose.
Record Level Parameters
ctry	ISO2 code for the country.
mak	A proprietary unique key identifier for an address.
lat	The corrected latitude.
long	The corrected longitude.
reason	Any additional information you want to add about the change request.
respondto	The email address to receive updates about the change request.

Code	Description
Request Level Parameters
CustomerID	Required. The License Key issued by Melissa.
TransmissionReference	Value passed through unchanged to the response for identification or any other purpose.
Record Level Parameters
Country	ISO2 code for the country.
MelissaAddressKey	A proprietary unique key identifier for an address.
Latitude	The corrected latitude.
Longitude	The corrected longitude.
Reason	Any additional information you want to add about the change request.
RespondToEmail	The email address to receive updates about the change request.

Headers

• GET JSON
• POST JSON

 Content-Type: application/json
 Accept: application/json

 Content-Type: application/json
 Accept: application/json

Response

• GET JSON
• POST JSON

{
    "Version": "8.4.0.1026",
    "TransmissionReference": "Test",
    "TransmissionResults": "",
    "Results": "MS01",
    "Message": "Thank you for submitting your geocoding 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."
}

{
    "Version": "8.4.0.1026",
    "TransmissionReference": "Test",
    "TransmissionResults": "",
    "Results": "MS01",
    "Message": "Thank you for submitting your geocoding 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."
}

/V4/WEB/changeMAK

Use this endpoint to submit a request to change a Melissa Address Key (MAK).

Try It Now

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

• POST JSON

curl -X POST "https://contribution.melissadata.net/V4/WEB/changeMAK" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
    "CustomerID": {{customerId}},
    "TransmissionReference": "Test",
    "Current":
    [{
       "Key": "AddressLine1",
       "Value": ""
    },
    {
       "Key": "City",
       "Value": ""
    }],
    "ChangeTo":
    [{
       "Key": "AddressLine1",
       "Value": "22382 Avenida Empresa"
    },
    {
       "Key": "City",
       "Value": "Rancho Santa Margarita"
    }],
    "MelissaAddressKey": "",
    "Reason": "MAK Change needed",
    "RespondToEmail": "youremail@melissadata.com"
    }'

Request Parameters

• POST JSON

Code	Description
Request Level Parameters
CustomerID	Required. The License Key issued by Melissa.
TransmissionReference	Value passed through unchanged to the response for identification or any other purpose.
Record Level Parameters
Current	This is a list of key/value pairs containing the original values before the change. The keys passed-in must align with ChangeTo. Empty or NULL values indicate no change. Code Description Key The name of the field for data set by the associated value. Value The data for a field set by the associated key.
ChangeTo	This is a list of key/value pairs containing the new values after the change. The keys passed-in must align with Current. Empty or NULL values indicate no change. Code Description Key The name of the field for data set by the associated value. Value The data for a field set by the associated key.
MelissaAddressKey	A proprietary unique key identifier for an address.
Reason	Any additional information you want to add about the change request.
RespondToEmail	The email address to receive updates about the change request.
Key Field Values (For Current/ChangeTo Parameters)
AddressKey	A unique identifier for a given address.
AddressLine1	A minimum address location for the contact.
AddressLine2	The second address line.
City	The city name.
Country	ISO2 code for the country.
Latitude	The latitude.
Longitude	The longitude.
State	The state name.
Suite	The suite number.
Urbanization	Only used for addresses in Puerto Rico. This is used to break ties between similar addresses in the same Postal Code.

Headers

• POST JSON

 Content-Type: application/json
 Accept: application/json

Response

• POST JSON

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

/V4/WEB/changeMIK

Use this endpoint to submit a request to change a Melissa Identification Key (MIK).

Try It Now

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

• POST JSON

curl -X POST "https://contribution.melissadata.net/V4/WEB/changeMIK" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
    "CustomerID": {{customerId}},
    "TransmissionReference": "Test",
    "Current":
    [{
       "Key": "AddressLine1",
       "Value": ""
    },
    {
       "Key": "City",
       "Value": ""
    }],
    "ChangeTo":
    [{
       "Key": "AddressLine1",
       "Value": "22382 Avenida Empresa"
    },
    {
       "Key": "City",
       "Value": "Rancho Santa Margarita"
    }],
    "MelissaIdentityKey": "",
    "Reason": "MIK Change needed",
    "RespondToEmail": "youremail@melissadata.com"
    }'

Request Parameters

• POST JSON

Code	Description
Request Level Parameters
CustomerID	Required. The License Key issued by Melissa.
TransmissionReference	Value passed through unchanged to the response for identification or any other purpose.
Record Level Parameters
Current	This is a list of key/value pairs containing the original values before the change. The keys passed-in must align with ChangeTo. Empty or NULL values indicate no change. Code Description Key The name of the field for data set by the associated value. Value The data for a field set by the associated key.
ChangeTo	This is a list of key/value pairs containing the new values after the change. The keys passed-in must align with Current. Empty or NULL values indicate no change. Code Description Key The name of the field for data set by the associated value. Value The data for a field set by the associated key.
MelissaIdentityKey	A proprietary unique key associated with a person.
Reason	Any additional information you want to add about the change request.
RespondToEmail	The email address to receive updates about the change request.
Key Field Values (For Current/ChangeTo Parameters)
AddressKey	A unique identifier for a given address.
AddressLine1	A minimum address location for the contact.
AddressLine2	The second address line.
City	The city name.
Country	ISO2 code for the country.
Latitude	The latitude.
Longitude	The longitude.
State	The state name.
Suite	The suite number.
Urbanization	Only used for addresses in Puerto Rico. This is used to break ties between similar addresses in the same Postal Code.

Headers

• POST JSON

 Content-Type: application/json
 Accept: application/json

Response

• POST JSON

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

/V4/WEB/removeMAK

Use this endpoint to submit a request to remove a Melissa Address Key (MAK) from the system.

Try It Now

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

• GET JSON
• POST JSON

curl -X GET "https://contribution.melissadata.net/V4/WEB/removeMAK?\
&id={{customerId}}\
&t=Test\
&act=delete\
&mak=8008006245\
&respondtoemail=youremail%40melissadata%2Ecom" \
-H "Content-Type:application/json" \
-H "Accept:application/json"

curl -X POST "https://contribution.melissadata.net/V4/WEB/removeMAK" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
    "CustomerID": {{customerId}},
    "TransmissionReference": "Test",
    "Action": "delete",
    "MelissaAddressKey": "8008006245",
    "RespondToEmail": "youremail@melissadata.com"
    }'

Note

MelissaAddressKey (mak) must already exist in the system.

Request Parameters

• GET JSON
• POST JSON

Code	Description
Request Level Parameters
id	Required. The License Key issued by Melissa.
t	Value passed through unchanged to the response for identification or any other purpose.
Record Level Parameters
act	This specifies the action to be taken. Possible Values delete - Delete the entire record from our database. suppression - Supresses the record from showing up in data requests.
mak	A proprietary unique key identifier for an address.
respondtoemail	The email address to receive updates about the change request.

Code	Description
Request Level Parameters
CustomerID	Required. The License Key issued by Melissa.
TransmissionReference	Value passed through unchanged to the response for identification or any other purpose.
Record Level Parameters
Action	This specifies the action to be taken. Possible Values delete - Delete the entire record from our database. suppression - Supresses the record from showing up in data requests.
MelissaAddressKey	A proprietary unique key identifier for an address.
RespondToEmail	The email address to receive updates about the change request.

Headers

• GET JSON
• POST JSON

 Content-Type: application/json
 Accept: application/json

 Content-Type: application/json
 Accept: application/json

Response

• GET JSON
• POST JSON

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

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

/V4/WEB/removeMIK

Use this endpoint to submit a request to remove a Melissa Identification Key (MIK) from the system.

Try It Now

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

• GET JSON
• POST JSON

curl -X GET "https://contribution.melissadata.net/V4/WEB/removeMIK?\
&id={{customerId}}\
&t=Test\
&act=delete\
&mik=8008006245\
&respondtoemail=youremail%40melissadata%2Ecom" \
-H "Content-Type:application/json" \
-H "Accept:application/json"

curl -X POST "https://contribution.melissadata.net/V4/WEB/removeMIK" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
    "CustomerID": {{customerId}},
    "TransmissionReference": "Test",
    "Action": "delete",
    "MelissaIdentityKey": "8008006245",
    "RespondToEmail": "youremail@melissadata.com"
    }'

Note

MelissaIdentityKey (mik) must already exist in the system.

Request Parameters

• GET JSON
• POST JSON

Minimum Inputs

The service requires at least one of the following input combinations:

Set	Fields
Set A	id, act, mik
Set B	id, a1, act, city, first, last, postal, state
Set C	id, a1, act, city, full, postal, state

Code	Description
Request Level Parameters
id	Required. The License Key issued by Melissa.
t	Value passed through unchanged to the response for identification or any other purpose.
Record Level Parameters
act	This specifies the action to be taken. Possible Values cpadelete - Erase personal data on the record. cpalimit - Object to personal data processing, including profiling and direct marketing. cpaoptout - Withdraw any consent given for personal data processing. delete - Delete the entire record from our database. suppression - Supresses the record from showing up in data requests.
a1	A minimum address location for the contact.
a2	The second address line.
city	The city name.
first	The parsed first name of an individual.
full	The full name of an individual.
last	The parsed last name of an individual.
mik	A proprietary unique key associated with a person.
postal	The ZIP Code.
respondtoemail	The email address to receive updates about the change request.
state	The state name.

Minimum Inputs

The service requires at least one of the following input combinations:

Set	Fields
Set A	CustomerID, Action, MelissaIdentificationKey
Set B	CustomerID, Action, AddressLine1, City, FirstName, LastName, PostalCode, State
Set C	CustomerID, Action, AddressLine1, City, FullName, PostalCode, State

Code	Description
Request Level Parameters
CustomerID	Required. The License Key issued by Melissa.
TransmissionReference	Value passed through unchanged to the response for identification or any other purpose.
Record Level Parameters
Action	This specifies the action to be taken. Possible Values cpadelete - Erase personal data on the record. cpalimit - Object to personal data processing, including profiling and direct marketing. cpaoptout - Withdraw any consent given for personal data processing. delete - Delete the entire record from our database. suppression - Supresses the record from showing up in data requests.
AddressLine1	A minimum address location for the contact.
AddressLine2	The second address line.
City	The city name.
FirstName	The parsed first name of an individual.
FullName	The full name of an individual.
LastName	The parsed last name of an individual.
MelissaIdentityKey	A proprietary unique key associated with a person.
PostalCode	The ZIP Code.
RespondToEmail	The email address to receive updates about the change request.
State	The state name.

Headers

• GET JSON
• POST JSON

 Content-Type: application/json
 Accept: application/json

 Content-Type: application/json
 Accept: application/json

Response

• GET JSON
• POST JSON

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

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

Response Fields

Service Level Response Fields

Output Name	Description
Version	The current service version number.
TransmissionReference	Serves as a unique request identifier.
TransmissionResults	Lists error codes from any errors caused by the most recent request as a whole.

Record Level Response Fields

Output Name	Description
Results	Comma delimited status, error codes, and change codes for the record.
Message	The response message for the request.

Result Codes

Melissa products use a result code system to indicate data quality; the status and any errors. These result codes are four-character codes (two letters followed by two numbers), delimited by commas. Result code definitions are shared among Melissa products.

Understanding the Code

To fully understand result codes, you need to know them. Knowing what codes are possible and what they indicate will be key in building an effective application. It is useful to know all the codes, but this does not necessarily mean you will use them all. Just because you have a toolbox, doesn’t mean you will also try to use a screwdriver along with a hammer on a nail.

Contribution Result Codes