Quickstart

Quickstart#

Introduction#

Welcome to the Melissa Contribution cloud service. 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.

Contribution can be used 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.

New to Melissa Cloud Services?#

We highly recommend first time users of our web services 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#

/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=\
&city=Ranch%20Santa%20Margarita\
&ctry=US\
&lat=33%2E637562\
&long=-117%2E606887\
&postal=92688\
&reason=Add%20a%20MAK\
&respondto=youremail%40melissadata%2Ecom\
&state=CA\
&ste=" \
-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": "",
    "City": "Rancho Stanta Margarita",
    "Country": "US",
    "Latitude": "33.637562",
    "Longitude": "-117.606887",
    "PostalCode": "string",
    "Reason": "Add a MAK",
    "RespondToEmail": "youremail@melissadata.com",
    "State": "CA",
    "Suite": ""
    }'

Add a new MIK#

You can submit a request to add a new Melissa Identification Key (MIK).

Endpoint#

/V4/WEB/addMIK

Click here to go to the full endpoint documentation.

Try it Now#
  • 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 Stanta Margarita"
    },
    {
       "Key": "State",
       "Value": "CA"
    },
    {
       "Key": "Country",
       "Value": "US"
    },
    {
       "Key": "Latitude",
       "Value": "33.637562"
    },
    {
       "Key": "Longitude",
       "Value": "-117.606887"
    }],
    "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 Change needed\
&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#

/V4/WEB/changeMAK

Click here to go to the full endpoint documentation.

Try it Now#
  • 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 Stanta 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#

/V4/WEB/changeMIK

Click here to go to the full endpoint documentation.

Try it Now#
  • 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 Stanta 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#

/V4/WEB/removeMAK

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/removeMAK?\
&id={{customerId}}\
&t=Test\
&act=delete\
&mak=8008006245\
&respondto=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#

/V4/WEB/removeMIK

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/removeMIK?\
&id={{customerId}}\
&t=Test\
&act=delete\
&mik=8008006245\
&respondto=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

melissa_favicon MelissaData/Contribution-Dotnet

Python3

melissa_favicon MelissaData/Contribution-Python3
Contents