Quickstart#
Introduction#
Welcome to the Melissa Contribution Cloud API. This service allows you to submit corrections for GeoPoints, where you can specify the MAK in question and submit the suggested latitude and/or longitude.
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 a new Melissa Address Key (MAK).
Endpoint#
Click here to go to the full endpoint documentation.
Try it Now#
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"
}'
Add a new MIK#
You can submit a request to add a new Melissa Identification Key (MIK).
Endpoint#
Click here to go to the full endpoint documentation.
Try it Now#
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"
}'
Change a GeoPoint#
You can submit a request to correct a GeoPoint.
Endpoint#
Click here to go to the full endpoint documentation.
Try it Now#
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"
}'
Change a MAK#
You can submit a request to change a Melissa Address Key (MAK).
Endpoint#
Click here to go to the full endpoint documentation.
Try it Now#
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"
}'
Change a MIK#
You can submit a request to change a Melissa Identification Key (MIK).
Endpoint#
Click here to go to the full endpoint documentation.
Try it Now#
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"
}'
Remove a MAK#
You can submit a request to remove a Melissa Address Key (MAK) from the system.
Endpoint#
Click here to go to the full endpoint documentation.
Try it Now#
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"
}'
Remove a MIK#
You can submit a request to remove a Melissa Identification Key (MIK) from the system.
Endpoint#
Click here to go to the full endpoint documentation.
Try it Now#
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"
}'
Sample Code#
Language |
Repository |
|---|---|
C# .NET |
|
Python3 |
