--- title: "Validate and retrieve businesses information" method: POST path: "/doBusinessCoderUS" tags: ["Business Validation"] --- # Validate and retrieve businesses information `POST /doBusinessCoderUS` 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` ## Headers - `Accept` 'application/json' | '*/*', required - `Content-Type` 'application/json' | '*/*', required ## Request body - Request - `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` - `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:< 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`. - `Records` RequestRecord[] - `a1` string — The first address line of the business. - `a2` string — The second address line (suite) of the business. - `city` string — The city (locality). - `comp` string — The name of the business. - `ctry` string — The country. - `freeform` string — This is a string value which can contain one of the possible minimum input requirements. - `mak` string — A proprietary unique key identifier for an address. This is derived from Address Checking. - `mek` string — The unique identifier given by Business Coder. - `phone` string — The phone number of the business. - `postal` string — The postal code. - `rec` string — The record ID. - `state` string — The state (Administrative Area). - `stock` string — A unique abbreviation/symbol assigned by the stock exchange for listed companies. - `suite` string — The suite. - `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. ## Response `200` 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. - Response - `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` ResponseRecord[], required — The returned array of records. - `AddressLine1` string — Address Line 1 of the business. - `CensusBlock` string — The census block number for the address. - `CensusTract` string — The census tract number for the address. - `City` string — City of the business. - `CompanyName` string — Name of the business. - `CountryCode` string — 2-Character Country Code - `CountryName` string — Name of Country based on address - `CountyFIPS` string — The FIPS code of the county. - `CountyName` string — The name of the county. - `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. - `DeliveryIndicator` string — The RBDI Indicator based on the address. - `EIN` string — Employer Identification Number - `EmployeesEstimate` string — The number of employees who work at this business location. - `Latitude` string — The latitude geo coordinate. - `LocationType` string — Code denoting the business location type. 0 - Headquarters, 1 - Branches, 2 - Subsidiary Headquarters, 3 - Single Location. - `Longitude` string — The longitude geo coordinate. - `MelissaEnterpriseKey` string — Unique Key assigned to a business for that location. - `MelissaAddressKey` string — (MAK) A unique key assigned to an address record. - `MelissaAddressKeyBase` string — A unique key assigned to the base address of a complex with apartments or suites. - `NAICSCode1` string — North American Industry Classification System code. This is related to SICCode1. - `NAICSCode2` string — Second NAICS code. This is related to SICCode2. - `NAICSCode3` string — Third NAICS code. This is related to SICCode3. - `NAICSDescription1` string — First NAICS code description. Related to NAICSCode1. - `NAICSDescription2` string — Second NAICS code description. Related to NAICSCode2. - `NAICSDescription3` string — Third NAICS code description. Related to NAICSCode3. - `Phone` string — 10-digit phone number. - `PlaceCode` string — The Census Bureau place code. - `PlaceName` string — The Census Bureau place name. - `Plus4` string — The Plus4 of the address. - `PostalCode` string — Zip/Postal Code of the business. - `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. - `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). - `SICCode1` string — A 6-digit SIC code for the business's primary line of business. - `SICCode2` string — The second SIC code. - `SICCode3` string — The third SIC code. - `SICDescription1` string — First SIC code description. Related to SICCode1. - `SICDescription2` string — Second SIC code description. Related to SICCode2. - `SICDescription3` string — Third SIC code description. Related to SICCode3. - `SalesEstimate` string — The sales volume and/or assets of the business in thousands. - `State` string — State of the business. - `StockTicker` string — The assigned stock exchange abbreviation/symbol for the business. - `Suite` string — The suite of the business. - `TotalContacts` string — Returns the number of employee contacts we have in our databases. - `WebAddress` string — The web address/domain for the business. - `Contacts` Contacts[] - `NameFirst` string — First Name of the contact. - `NameLast` string — Last Name of the contact. - `Gender` string — Gender of the contact. - `Title` string — Title of the contact. - `ContactPhone` string — Phone number of the contact. - `Email` string — Email of the contact. ## Other responses - `400` — Bad Request --- [API](https://skmtc.dev/melissa/apis/us-business-coder.md) · [All operations](https://skmtc.dev/melissa/apis/us-business-coder/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/melissa/us-business-coder/revisions/afc0c12a492c/schema)