Business Coder:Request

← Business Coder

A request consists of a protocol to make a call to the service, detailing desired elements. Your License Key is required.

Business Coder supports the JSON and REST protocols to access the service.

URL

Use	URL
Standard	http://businesscoder.melissadata.net/WEB/BusinessCoder/doBusinessCoderUS
Secure	https://businesscoder.melissadata.net/WEB/BusinessCoder/doBusinessCoderUS

Field Names

This is a list of the request field names and their protocol naming conventions.

Field Name	Level	REST	JSON
Transmission Reference	Request	t	t
License Key		id	id
Column		cols	cols
Options		opt	opt
Record ID	Record	rec	rec
Company Name		comp	comp
Phone Number		phone	phone
Address1		a1	a1
Address2		a2	a2
Suite		suite	suite
City		city	city
State		state	state
Postal		postal	postal
Country		ctry	ctry
Melissa Address Key (MAK)		mak	mak
Stock Ticker		stock	stock
Web Address		web	web
Melissa Enterprise Key (MEK)		mek	mek
Free Form		ff	freeform

Minimum Inputs

The following are the possible minimum input requirements.

1. Company Only
2. MAK and Company
3. Address Only
4. MAK Only
5. Phone Number
6. Stock Ticker
7. Web Address

Request Elements

The following elements set the basic options for each request. These apply to the entire request, not the individual records.

Transmission Reference

Optional.

This is a string value that serves as a unique identifier for this set of records. It is returned as sent.

Protocol	Syntax
JSON	"t":"string"
REST	?t = string

License Key

Required.

This is a string value containing the License Key issued to the customer by Melissa Data for the Business Coder.

If this element is absent, the Web Service will return an error. To receive a License Key, please contact your Melissa Data sales representative at 1-800-MELISSA.

Protocol	Syntax
JSON	"id":"string"
REST	&id = string

Column

Optional.

This string value specifies which column(s) to be output as a comma delimited string.

Protocol	Syntax
JSON	"cols":"string"
REST	&cols = string

Entering the column name to return the column. Specifying a group name will return all columns in the group.

Field Name	Group
TransmissionResults	[DEFAULT] These columns are returned by default.
TransmissionReference
Records
RecordID
CompanyName
CurrentCompanyName
AddressLine1
Suite
City
State
PostalCode
TotalContacts
MelissaEnterpriseKey
LocationType	[NO GROUP] These columns must be requested individually.
Phone
EmployeesEstimate
SalesEstimate
StockTicker
WebAddress
Contacts
CountryCode	GrpAddressDetails
CountryName
DeliveryIndicator
MelissaAddressKey
MelissaAddressKeyBase
Plus4
EIN	GrpBusinessCodes
SICCode1
SICCode2
SICCode3
NAICSCode1
NAICSCode2
NAICSCode3
SICDescription1	GrpBusinessDescription
SICDescription2
SICDescription3
NAICSDescription1
NAICSDescription2
NAICSDescription3
Latitude	GrpGeoCode
Longitude
CountyName	GrpCensus
CountyFIPS
CensusTract
CensusBlock
PlaceCode
PlaceName

JSON Array returned by Contacts
Contacts:
NameFirst
NameLast
Gender
Title
Email

Options

Optional.

This is a string value containing the options set by the user.

Protocol	Syntax
JSON	"opt":"string"
REST	&opt = string

List options in the following format.

Syntax
OptionName:Parameter

CentricHint

This option allows you to choose what the service will center the search around.

Option Name	Parameter	Description
CentricHint	company	Will use Company as the primary pivot.
	address	Will us Address as a primary pivot.
	phone	Will use Phone as a primary pivot.

MaxContacts

This option changes the upper limit on the number of contacts returned.

Option Name	Parameter	Description
MaxContacts	# [0 - #]	Default set to 5. Sets the maximum number of contacts to be returned.

ReturnDominantBusiness

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.

Option Name	Parameter	Description
ReturnDominantBusiness	yes	Default. Return the dominant business name when the company information is missing or does not match.
	no	Do not return the dominant business name when the company information is missing or does not match.

SICNAICSConfidence

Will only return SIC Codes that we are very confident are correct. If they do not pass our requirements we will return null.

Option Name	Parameter	Description
SICNAICSConfidence	strict	Returns very confident or correct SIC Codes. Returns null if none pass the requirement.
	loose	Default. Returns any associated SIC Codes.

Request Record Elements

REST will only contain the Records element.

Protocol	Definition
JSON	Each record will be contained within [{}] under the Records element.
REST	The REST interface only allows a single record per request.

Record ID

Optional.

This is a string value containing a unique identifier for the current record. Use this to match the record submitted with the record returned. It will return what is inputted.

Protocol	Syntax
JSON	"rec":"string"
REST	&rec = string

Company Name

Optional.

The name of the business.

Protocol	Syntax
JSON	"comp":"string"
REST	&comp = string

Phone Number

Optional.

The phone number of the business.

Protocol	Syntax
JSON	"phone":"string"
REST	&phone = string

Address1

Optional.

The first address line of the business.

Protocol	Syntax
JSON	"a1":"string"
REST	&a1 = string

Address2

Optional.

The second address line (suite) of the business.

Protocol	Syntax
JSON	"a2":"string"
REST	&a2 = string

Suite

Optional.

The suite/apartment number for the business.

Protocol	Syntax
JSON	"suite":"string"
REST	&suite = string

City

Optional.

The city (locality).

Protocol	Syntax
JSON	"city":"string"
REST	&city = string

State

Optional.

The state (Administrative Area).

Protocol	Syntax
JSON	"state":"string"
REST	&state = string

Postal

Optional.

The postal code.

Protocol	Syntax
JSON	"postal":"string"
REST	&postal = string

Country

Optional.

The country.

Protocol	Syntax
JSON	"ctry":"string"
REST	&ctry = string

Melissa Address Key (MAK)

Optional.

A propietary unique key identifier for an address. This is derived from Address Checking.

Protocol	Syntax
JSON	"mak":"string"
REST	&mak = string

Stock Ticker

Optional.

A unique abbreviation/symbol assigned by the stock exchange for listed companies.

Protocol	Syntax
JSON	"stock":"string"
REST	&stock = string

Web Address

Optional.

The web address/domain for a company.

Protocol	Syntax
JSON	"web":"string"
REST	&web = string

Melissa Enterprise Key (MEK)

Optional.

The unique identifier given by Business Coder.

Protocol	Syntax
JSON	"mek":"string"
REST	&mek = string

Free Form

Optional.

This is a string value which can contain one of the possible minimum input requirements.

NOTE: If freeform is populated it will ignore all other input fields.

Protocol	Syntax
JSON	"ff":"string"
REST	&freeform = string