v1
latestOpenAPI 3.1.02026-08-062526.3 KBValidate and retrieve business information.
The service requires at least one of the following input combinations:
Set A - a1, city, state, postal
Set B - ff
Set C - phone
Set D - stock
Set E - web
Query parameters
Transmission Reference - Serves as a unique identifier for this set of records. This allows you to match a response to a request.
Required. The License Key issued by Melissa.
Columns - The column names or groups to be output.
Entering the column name will return the column. Specifying a group name will return all columns in the group.
Delimit multiple columns with a ,.
For example: ColumnName,ColumnName.
- [DEFAULT] These columns are returned by default.
- AddressLine1
- City
- CompanyName
- CurrentCompanyName
- MelissaEnterpriseKey
- PostalCode
- RecordID
- Records
- State
- Suite
- TotalContacts
- TransmissionReference
- TransmissionResults
- [NO GROUP] These columns must be requested individually.
- Contacts
- EmployeesEstimate
- LocationType
- Phone
- SalesEstimate
- StockTicker
- WebAddress
- GrpAddressDetails
- CountryCode
- CountryName
- DeliveryIndicator
- MelissaAddressKey
- MelissaAddressKeyBase
- Plus4
- GrpBusinessCodes
- EIN
- NAICSCode1
- NAICSCode2
- NAICSCode3
- SICCode1
- SICCode2
- SICCode3
- GrpBusinessDescription
- NAICSDescription1
- NAICSDescription2
- NAICSDescription3
- SICDescription1
- SICDescription2
- SICDescription3
- GrpGeoCode
- Latitude
- Longitude
- GrpCensus
- CensusBlock
- CensusTract
- CountyFIPS
- CountyName
- PlaceCode
- PlaceName
Options - Pass in options you want to set for the request.
List options in the format OptionName:Parameter, with multiple options delimited with a ,. For example: OptionName:Parameter,OptionName:Parameter
- CentricHint:< company | address | phone > - This option allows you to choose what the service will center the search around.
- MaxContacts:< 1 | 5 | 10 > - This option changes the upper limit on the number of contacts returned. Default is 5.
- ReturnDominantBusiness:< yes | no > - This option handles the returning of the dominant business name and demographics for a particular site when the company information is missing or does not match. Default is yes.
- SICNAICSConfidence:< strict | loose > - This option handles how SIC Codes are returned, depending on our SIC Code confidence level. Default is loose.
Record ID - Unique identifier for current record
Company Name - Business namespace
Phone Number - Business phone number
Address1 - First address line
Address2 - Second address line (suite)
Suite - Suite number
City - City name
State - State name
Postal - Postal code
Country - Country name
Melissa Address Key (MAK) - Proprietary unique key identifier
Stock Ticker - Unique stock exchange symbol/abbreviation
Web Address - Web address/domain
Melissa Enterprise Key (MEK) - Proprietary unique key identifier
Free Form
Headers
Format of the response.
Format of the request.
Response
A response is the result of a request. This consists of returned results codes and parsed, corrected, and/or appended request elements, depending on the options selected.