# Validate and retrieve businesses information An HTTPS POST is issued with the "ContentType" header specifying the format of the request and the "Accept" header specifying the format of the response. _Note:_ A request to the Business Coder Cloud Service must consist of the License Key and either Address, MAK and Company, Stock Ticker, Web Address, or Phone to verify. Endpoint: POST /doBusinessCoderUS ## 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) 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.$.` (array) A detailed message about the error. - `traceId` (string) A unique identifier for the request, useful for debugging.