# Validate and retrieve businesses information

Submit a batch request to validate and retrieve businesses information.

The service requires at least one of the following input combinations:

Set A - a1, city, state, postal

Set B - freeform

Set C - phone

Set D - stock

Set E - web

Endpoint: POST /doBusinessCoderUS

## Header parameters:

  - `Accept` (string, required)
    Format of the response.
    Enum: "application/json", "*/*"

  - `Content-Type` (string, required)
    Format of the request.
    Enum: "application/json", "*/*"

## Request fields (application/json):

  - `cols` (string)
    [Columns](https://docs.melissa.com/cloud-api/business-coder/business-coder-reference-guide.html#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
    Example: "GrpAddressDetails,GrpBusinessCodes"

  - `id` (string, required)
    Required. The [License Key](https://docs.melissa.com/melissa/license/license-information.html) issued by Melissa.

  - `opt` (string)
    [Options](https://docs.melissa.com/cloud-api/business-coder/business-coder-reference-guide.html#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: - This option allows you to choose what the service will center the search around.
- MaxContacts: - This option changes the upper limit on the number of contacts returned. Default is 5.
- 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. Default is yes.
- SICNAICSConfidence: - This option handles how SIC Codes are returned, depending on our SIC Code confidence level. Default is loose.
    Example: "CentrictHint:company,MaxContacts:5"

  - `Records` (array)

  - `Records.a1` (string)
    The first address line of the business.
    Example: "22382 Avenida Empresa"

  - `Records.a2` (string)
    The second address line (suite) of the business.

  - `Records.city` (string)
    The city (locality).
    Example: "Rancho Santa Margarita"

  - `Records.comp` (string)
    The name of the business.
    Example: "Melissa Data"

  - `Records.ctry` (string)
    The country.
    Example: "US"

  - `Records.freeform` (string)
    This is a string value which can contain one of the possible minimum input requirements.

  - `Records.mak` (string)
    A proprietary unique key identifier for an address. This is derived from Address Checking.

  - `Records.mek` (string)
    The unique identifier given by Business Coder.

  - `Records.phone` (string)
    The phone number of the business.
    Example: "8006354772"

  - `Records.postal` (string)
    The postal code.
    Example: "92688"

  - `Records.rec` (string)
    The record ID.
    Example: 1

  - `Records.state` (string)
    The state (Administrative Area).
    Example: "California"

  - `Records.stock` (string)
    A unique abbreviation/symbol assigned by the stock exchange for listed companies.

  - `Records.suite` (string)
    The suite.

  - `Records.web` (string)
    The web address/domain for a company.

  - `t` (string)
    Serves as a unique identifier for this set of records. This allows you to match a response to a request.
    Example: "Business Coder Test"

## Response 200 fields (application/json):

  - `TransmissionResults` (string, required)
    Returns the generic service level result/error codes. For more information, see [Business Coder Result Codes](https://docs.melissa.com/cloud-api/business-coder/result-codes.html).

  - `TransmissionReference` (string, required)
    A pass-through of the input Transmission Reference.

  - `Version` (string, required)
    The current service version number.

  - `TotalRecords` (string, required)
    Total number of records returned in the records array.

  - `Records` (array, required)
    The returned array of records.

  - `Records.AddressLine1` (string)
    Address Line 1 of the business.

  - `Records.CensusBlock` (string)
    The census block number for the address.

  - `Records.CensusTract` (string)
    The census tract number for the address.

  - `Records.City` (string)
    City of the business.

  - `Records.CompanyName` (string)
    Name of the business.

  - `Records.CountryCode` (string)
    2-Character Country Code

  - `Records.CountryName` (string)
    Name of Country based on address

  - `Records.CountyFIPS` (string)
    The FIPS code of the county.

  - `Records.CountyName` (string)
    The name of the county.

  - `Records.CurrentCompanyName` (string)
    The company name in our reference data. You can use this to easily compare your input company name against Melissa records for that address.

  - `Records.DeliveryIndicator` (string)
    The RBDI Indicator based on the address.

  - `Records.EIN` (string)
    Employer Identification Number

  - `Records.EmployeesEstimate` (string)
    The number of employees who work at this business location.

  - `Records.Latitude` (string)
    The latitude geo coordinate.

  - `Records.LocationType` (string)
    Code denoting the business location type. 0 - Headquarters, 1 - Branches, 2 - Subsidiary Headquarters, 3 - Single Location.

  - `Records.Longitude` (string)
    The longitude geo coordinate.

  - `Records.MelissaEnterpriseKey` (string)
    Unique Key assigned to a business for that location.

  - `Records.MelissaAddressKey` (string)
    (MAK) A unique key assigned to an address record.

  - `Records.MelissaAddressKeyBase` (string)
    A unique key assigned to the base address of a complex with apartments or suites.

  - `Records.NAICSCode1` (string)
    North American Industry Classification System code. This is related to SICCode1.

  - `Records.NAICSCode2` (string)
    Second NAICS code. This is related to SICCode2.

  - `Records.NAICSCode3` (string)
    Third NAICS code. This is related to SICCode3.

  - `Records.NAICSDescription1` (string)
    First NAICS code description. Related to NAICSCode1.

  - `Records.NAICSDescription2` (string)
    Second NAICS code description. Related to NAICSCode2.

  - `Records.NAICSDescription3` (string)
    Third NAICS code description. Related to NAICSCode3.

  - `Records.Phone` (string)
    10-digit phone number.

  - `Records.PlaceCode` (string)
    The Census Bureau place code.

  - `Records.PlaceName` (string)
    The Census Bureau place name.

  - `Records.Plus4` (string)
    The Plus4 of the address.

  - `Records.PostalCode` (string)
    Zip/Postal Code of the business.

  - `Records.RecordID` (string)
    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.

  - `Records.Results` (string)
    Returns record specific result codes. For more information, see [Business Coder Result Codes](https://docs.melissa.com/cloud-api/business-coder/result-codes.html).

  - `Records.SICCode1` (string)
    A 6-digit SIC code for the business's primary line of business.

  - `Records.SICCode2` (string)
    The second SIC code.

  - `Records.SICCode3` (string)
    The third SIC code.

  - `Records.SICDescription1` (string)
    First SIC code description. Related to SICCode1.

  - `Records.SICDescription2` (string)
    Second SIC code description. Related to SICCode2.

  - `Records.SICDescription3` (string)
    Third SIC code description. Related to SICCode3.

  - `Records.SalesEstimate` (string)
    The sales volume and/or assets of the business in thousands.

  - `Records.State` (string)
    State of the business.

  - `Records.StockTicker` (string)
    The assigned stock exchange abbreviation/symbol for the business.

  - `Records.Suite` (string)
    The suite of the business.

  - `Records.TotalContacts` (string)
    Returns the number of employee contacts we have in our databases.

  - `Records.WebAddress` (string)
    The web address/domain for the business.

  - `Records.Contacts` (array)

  - `Records.Contacts.NameFirst` (string)
    First Name of the contact.

  - `Records.Contacts.NameLast` (string)
    Last Name of the contact.

  - `Records.Contacts.Gender` (string)
    Gender of the contact.

  - `Records.Contacts.Title` (string)
    Title of the contact.

  - `Records.Contacts.ContactPhone` (string)
    Phone number of the contact.

  - `Records.Contacts.Email` (string)
    Email of the contact.

## Response 400 fields (application/json):

  - `type` (string)
    The type of error that occurred.

  - `title` (string)
    A short summary of the error.

  - `status` (integer)
    The HTTP status code for the error.

  - `errors` (object)

  - `errors.$.<PropertyName>` (array)
    A detailed message about the error.

  - `traceId` (string)
    A unique identifier for the request, useful for debugging.