Quickstart Guide

Using Melissa Web Services

Melissa offers a wide array of Web Services from address verification, geocoding, to property information and business firmographics. Most of our web services will follow the same schema for the request/response, and is accessible through industry standard protocols including REST, JSON, XML and SOAP.

All Melissa Web Services require a license in order to be accessed. Melissa offers trial and demo licenses to the same service as a fully paid license so you can transition from a trial to a full subscription without any changes. To start a trial, please contact your sales representative. If you do not have one, please call 1-800-MELISSA or email Sales@melissa.com. Alternatively, some services allows developer credits to be used on an as needed basis. More information here: https://www.melissa.com/pricing/purchase

Last Updated 05/21/2020

Most Melissa Web Service APIs will follow a similar request structure, but with some variation specific to each service.

REST

  • DOMAIN – Indicates which web service to access.
  • SUB DIRECTORY/PATH – Indicates exactly which endpoint to use for the API
  • QUERY – Contains the request elements to the API
https://personator.melissadata.net/v3/WEB/ContactVerify/doContactVerify?format=json&id=66778150&act=Check&a1=22382+Avenida+Empresa&postal=92688

XML/JSON

  • GLOBAL SETTINGS – Contains any global input settings such as the customer ID, Options, and column requests.
  • RECORD ARRAY – Contains a single or multiple record array.
<Request>
    <CustomerID>CUSTOMERID</CustomerID>
    <Options/>
    <Records>
        <RequestRecord>
            <Input1>string</Input1>
            <Input2>string</Input2>
            
            
            <Input10>string</Input10>
        </RequestRecord>
    </Records>
</Request>
{
  "CustomerID":"string",
  "Options":"string",
  "Records":[
    {
      "Input1":"string",
      "Input2":"string",
        
        
      "Input10":"string",
    }
  ]
}
Last Updated 05/21/2020

Most Melissa Web Services will allow for sending up to 100 records in a single request. This reduces the amount overhead produced from continuous back and forth communication between the service and client.

Batch Processing is only available in the JSON, XML and SOAP protocols.

XML/JSON

  • GLOBAL SETTINGS – Contains any global input settings such as the customer ID, Options, and column requests.
  • RECORD ARRAY – Contains a single or multiple record array.
<Request>
    <CustomerID>CUSTOMERID</CustomerID>
    <Options/>
    <Records>
        <RequestRecord>
            <Input1>string</Input1>
            <Input2>string</Input2>
            
            
            <Input10>string</Input10>
        </RequestRecord>
        
        
        <RequestRecord>
            <Input1>string</Input1>
            <Input2>string</Input2>
            
            
            <Input10>string</Input10>
        </RequestRecord>
    </Records>
</Request>

Up to 100 records can be in the arrays.

{
  "CustomerID":"string",
  "Options":"string",
  "Records":[
    {
      "Input1":"string",
      "Input2":"string",
        
        
      "Input10":"string",
    },
        
        
    {
      "Input1":"string",
      "Input2":"string",
        
        
      "Input10":"string",
    }
  ]
}
Last Updated 05/21/2020