Skip to content
/Add MAK

Contribution

Overview

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

You can use Contribution to:

  • 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.

Documentation

Useful Resources

Support Center

https://www.melissa.com/company/product-support

Download OpenAPI description
contribution.json
contribution.yaml
Languages
Servers
Contribution Server
http://contribution.melissadata.net/V4/WEB/

Change GeoPoint

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

Operations

Add MAK

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

Operations

Add a new MAK

Request

Uses HTTPS GET to accept one input record and returns the response in JSON format.

Query
tstring

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

Example: t=Test
idany(password)required

The License Key issued by Melissa.

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

Required. 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

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

Example: admarea=CA
ctrystringrequired

Required. ISO2 code for the country.

Example: ctry=US
latnumberrequired

Required. The latitude. Optional if Longitude is provided.

Example: lat=33.637562
locstringrequired

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

Example: loc=Rancho Santa Margarita
longnumberrequired

Required. The longitude. Optional if Latitude is provided.

Example: long=-117.606887
orgstring

The organization name.

postalstringrequired

Required. 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
curl -i -X GET \
  'http://contribution.melissadata.net/V4/WEB/addMAK?id={REPLACE-WITH-YOUR-LICENSE-KEY}&a1=22382+Avenida+Empresa&admarea=CA&ctry=US&lat=33.637562&loc=Rancho+Santa+Margarita&long=-117.606887&postal=92688'

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

Add a new MAK

Request

An HTTPS POST is issued with the "ContentType" header specifying the format of the request and the "Accept" header specifying the format of the response.

Bodyapplication/jsonrequired
CustomerIDstringrequired

The License Key issued by Melissa.

TransmissionReferencestring

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

AddressLine1stringrequired

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.

AdministrativeAreastringrequired

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

Countrystringrequired

ISO2 code for the country.

Latitudestringrequired

The corrected latitude. Optional if Longitude is provided.

Localitystringrequired

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

Longitudestringrequired

The corrected longitude. Optional if Latitude is provided.

Organizationstring

The organization name.

PostalCodestringrequired

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 '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
application/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."
}

Change MAK

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

Operations

Remove MAK

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

Operations

Add MIK

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

Operations

Change MIK

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

Operations

Remove MIK

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

Operations