# Get record count and sample of businesses This endpoint allows API users to retrieve a count and 10 record sample of the results to preview before purchasing a file version of the full dataset. Endpoint: POST /Business/getCount ## Header parameters: - `Accept` (string, required) Format of the response. Enum: "application/json", "*/*" - `Content-Type` (string, required) Format of the request. Enum: "application/json", "application/xml" ## Request fields (application/json): - `CustomerID` (string, required) The [License Key](https://docs.melissa.com/melissa/license/license-information.html) issued by Melissa. - `Includes` (object, required) Any parameter you would like to include in the query. Requires at least one from: - Zips - Cities - Radius - ShapeWKTs - `Includes.Zips` (array) A list of Zips objects containing Zip codes and optionally Plus4. - `Includes.Zips.Zip` (string, required) - `Includes.Zips.Plus4` (string) - `Includes.Cities` (array) A list of cities objects each containing City and State. - `Includes.Cities.City` (string, required) - `Includes.Cities.State` (string, required) - `Includes.Radius` (object) A Radius object containing a Latitude, Longitude, and Distance represented in miles. - `Includes.Radius.Latitude` (number, required) - `Includes.Radius.Longitude` (number, required) - `Includes.Radius.Distance` (number, required) - `Includes.ShapeWKTs` (array) A list of WKT polygon strings - `Includes.PrimarySICCode` (array) The primary line of business represented by a Standard Industrial Classification code. - `Includes.RBDI` (array) An RBDI code. - `Includes.FIPSCode` (array) A list of FIPSCodes. - `Includes.Email` (array) Email. - `Includes.EmailDeliverableInd` (array) The deliverability status of the email address. - `Includes.EmailMarketableInd` (boolean) The marketable status of the email address. - `Includes.JobTitles` (array) Descriptive label of the individual's job. - `Includes.LanguagesSpoken` (array) Descriptive label of the individual's job. - `Includes.ManagementLevelLabels` (array) Describes the contact's position relative to others in their organization. - `Includes.TitleCodes` (array) A list of title codes. - `Includes.TitleCodesLabels` (array) A list of title codes labels. - `Includes.SecondarySicCodeIds` (array) The line of business represented by a Standard Industrial Classification code. - `Includes.NAICSCode1` (array) The primary line of business represented by a North American Industry Classification System code. - `Includes.NAICSCode2` (array) The lines of business represented by North American Industry Classification System codes. - `Includes.CorporateEmployeeCount` (object) The actual, reported total number of employees at all locations in a corporate family. - `Includes.CorporateEmployeeCount.minimum` (integer) - `Includes.CorporateEmployeeCount.maximum` (integer) - `Includes.EstimatedCorporateEmployeeCount` (object) Estimates the total number of employees at all locations in a corporate family. - `Includes.EstimatedCorporateEmployeeCount.minimum` (integer) - `Includes.EstimatedCorporateEmployeeCount.maximum` (integer) - `Includes.LocationEmployeeCount` (object) The number of employees who work at this place. - `Includes.LocationEmployeeCount.minimum` (integer) - `Includes.LocationEmployeeCount.maximum` (integer) - `Includes.EstimatedLocationEmployeeCount` (object) Estimates the number of employees who work at this location. - `Includes.EstimatedLocationEmployeeCount.minimum` (integer) - `Includes.EstimatedLocationEmployeeCount.maximum` (integer) - `Includes.LocationSalesVolume` (object) An estimation of the place's sales revenue. - `Includes.LocationSalesVolume.minimum` (integer) - `Includes.LocationSalesVolume.maximum` (integer) - `Includes.ContactEmail` (array) The email address of the contact. - `Includes.ContactEmailDeliverableInd` (array) The deliverability status of the email address. - `Includes.ContactEmailMarketableInd` (boolean) The marketable status of the email address. - `Includes.CBSACode` (array) The core based statistical area where the place is located. - `Includes.CBSALevel` (array) Information on whether the CBSA is a micropolitan or metropolitan area. - `Includes.CSACode` (array) The combined statistical area code where the place is located. - `Includes.ContactApider` (array) The gender of the individual. - `Includes.ContactJobFunctionId` (array) Describes the type of work an employee performs in their organization. - `Includes.ContactJobTitles` (array) Descriptive label of the individual's job. - `Includes.ContactJobTitlesCount` (array) The total number of Job titles associated with the contact. - `Includes.ContactManagementLevel` (array) Describes the contact's position relative to others in their organization. - `Includes.ContactProfessionalTitle` (array) The professional degree or title of the individual. - `Includes.ContactIndicator` (array) Information on whether the individual is the primary contact for the location. - `Includes.ContactSuppressedFields` (array) The fields on the individual that are suppressed. - `Includes.ContactTitleCodes` (array) A list of the individual's job titles. - `Includes.Website` (array) The primary homepage URL of the business. - `Includes.WorkAtHome` (boolean) The place is a work at home business. - `Includes.OpenedForBusinessOn` (array) The date when the place opened for business. - `Includes.EstimatedOpenedForBusiness` (object) Range of the estimated date when the place opened for business. - `Includes.EstimatedOpenedForBusiness.minimum` (string) - `Includes.EstimatedOpenedForBusiness.maximum` (string) - `Includes.CorporateFranchising` (boolean) Determine if the corporation includes franchised branches. - `Includes.CorporateSalesRevenue` (array) The actual, reported sales revenue for the corporate family. - `Includes.EstimatedCorporateSalesRevenue` (array) Estimates total sales revenue for the corporate family. - `Includes.RestaurantCuisines` (array) The type of cuisine served at the place. - `Excludes` (object) Any parameter you would like to exclude in the query. - `Excludes.Zips` (array) A list of Zips objects containing Zip codes and optionally Plus4. - `Excludes.Zips.Zip` (string, required) - `Excludes.Zips.Plus4` (string) - `Excludes.Cities` (array) A list of cities objects each containing City and State. - `Excludes.Cities.City` (string, required) - `Excludes.Cities.State` (string, required) - `Excludes.PrimarySICCode` (array) The primary line of business represented by a Standard Industrial Classification code. - `Excludes.RBDI` (array) An RBDI code. - `Excludes.FIPSCode` (array) A list of FIPSCodes. - `Excludes.Email` (array) Email. - `Excludes.EmailDeliverableInd` (array) The deliverability status of the email address. - `Excludes.EmailMarketableInd` (boolean) The marketable status of the email address. - `Excludes.JobTitles` (array) Descriptive label of the individual's job. - `Excludes.LanguagesSpoken` (array) Descriptive label of the individual's job. - `Excludes.ManagementLevelLabels` (array) Describes the contact's position relative to others in their organization. - `Excludes.TitleCodes` (array) A list of title codes. - `Excludes.TitleCodesLabels` (array) A list of title codes labels. - `Excludes.SecondarySicCodeIds` (array) The line of business represented by a Standard Industrial Classification code. - `Excludes.NAICSCode1` (array) The primary line of business represented by a North American Industry Classification System code. - `Excludes.NAICSCode2` (array) The lines of business represented by North American Industry Classification System codes. - `Excludes.CorporateEmployeeCount` (object) The actual, reported total number of employees at all locations in a corporate family. - `Excludes.CorporateEmployeeCount.minimum` (integer) - `Excludes.CorporateEmployeeCount.maximum` (integer) - `Excludes.EstimatedCorporateEmployeeCount` (object) Estimates the total number of employees at all locations in a corporate family. - `Excludes.EstimatedCorporateEmployeeCount.minimum` (integer) - `Excludes.EstimatedCorporateEmployeeCount.maximum` (integer) - `Excludes.LocationEmployeeCount` (object) The number of employees who work at this place. - `Excludes.LocationEmployeeCount.minimum` (integer) - `Excludes.LocationEmployeeCount.maximum` (integer) - `Excludes.EstimatedLocationEmployeeCount` (object) Estimates the number of employees who work at this location. - `Excludes.EstimatedLocationEmployeeCount.minimum` (integer) - `Excludes.EstimatedLocationEmployeeCount.maximum` (integer) - `Excludes.LocationSalesVolume` (object) An estimation of the place's sales revenue. - `Excludes.LocationSalesVolume.minimum` (integer) - `Excludes.LocationSalesVolume.maximum` (integer) - `Excludes.ContactEmail` (array) The email address of the contact. - `Excludes.ContactEmailDeliverableInd` (array) The deliverability status of the email address. - `Excludes.ContactEmailMarketableInd` (boolean) The marketable status of the email address. - `Excludes.CBSACode` (array) The core based statistical area where the place is located. - `Excludes.CBSALevel` (array) Information on whether the CBSA is a micropolitan or metropolitan area. - `Excludes.CSACode` (array) The combined statistical area code where the place is located. - `Excludes.ContactApider` (array) The gender of the individual. - `Excludes.ContactJobFunctionId` (array) Describes the type of work an employee performs in their organization. - `Excludes.ContactJobTitles` (array) Descriptive label of the individual's job. - `Excludes.ContactJobTitlesCount` (array) The total number of Job titles associated with the contact. - `Excludes.ContactManagementLevel` (array) Describes the contact's position relative to others in their organization. - `Excludes.ContactProfessionalTitle` (array) The professional degree or title of the individual. - `Excludes.ContactIndicator` (array) Information on whether the individual is the primary contact for the location. - `Excludes.ContactSuppressedFields` (array) The fields on the individual that are suppressed. - `Excludes.ContactTitleCodes` (array) A list of the individual's job titles. - `Excludes.Website` (array) The primary homepage URL of the business. - `Excludes.WorkAtHome` (boolean) The place is a work at home business. - `Excludes.OpenedForBusinessOn` (array) The date when the place opened for business. - `Excludes.EstimatedOpenedForBusiness` (object) Range of the estimated date when the place opened for business. - `Excludes.EstimatedOpenedForBusiness.minimum` (string) - `Excludes.EstimatedOpenedForBusiness.maximum` (string) - `Excludes.CorporateFranchising` (boolean) Determine if the corporation includes franchised branches. - `Excludes.CorporateSalesRevenue` (array) The actual, reported sales revenue for the corporate family. - `Excludes.EstimatedCorporateSalesRevenue` (array) Estimates total sales revenue for the corporate family. - `Excludes.RestaurantCuisines` (array) The type of cuisine served at the place. - `Columns` (array, required) All [Business Columns](https://docs.melissa.com/reference-data/data-retriever/data-retriever-reference-guide.html#business) you want returned. Enum: "MelissaAddressKey", "BaseMelissaAddressKey", "Name", "AddressLine", "Suite", "City", "State", "ZIPCode", "Plus4", "DeliveryPoint", "AddressKey", "ResultCodes", "AddressStreetNumber", "AddressDirectionPrefix", "AddressStreetName", "AddressStreetSuffix", "AddressDirectionSuffix", "AddressSuiteName", "AddressSuiteNumber", "AddressTypeCode", "CarrierRoute", "FIPSCode", "CMRAInd", "AddressChangedDate", "LandmarkAddress", "MailingMelissaAddresskey", "MailingBaseMelissaAddresskey", "MailingAddressLine", "MailingAddressSuite", "MailingAddressCity", "MailingAddressState", "MailingAddressZIPCode", "MailingAddressPlus4", "MailingDeliveryPoint", "MailingAddressKey", "MailingResultCodes", "MailingAddressStreetNumber", "MailingAddressDirectionPrefix", "MailingAddressStreetName", "MailingAddressStreetSuffix", "MailingAddressDirectionSuffix", "MailingAddressSuiteName", "MailingAddressSuiteNumber", "MailingAddressTypeCode", "MailingAddressCarrierRoute", "MailingAddressFIPSCode", "MailingAddressCMRAInd", "PrimarySICCodeId", "SecondarySicCodeIds", "NAICSCode1", "NAICSCode2", "ContactFirstName", "ContactLastName", "PhoneNumber", "TollFreeNumber", "PhoneNumber2", "FaxNumber", "CorporateEmployeeCount", "EstimatedCorporateEmployeeCount", "LocationEmployeeCount", "EstimatedLocationEmployeeCount", "LocationSalesVolume", "ContactEmail", "ContactEmailDeliverableInd", "ContactEmailMarketableInd", "Latitude", "Longitude", "Censuskey", "CensusBlock", "CensusTract", "SgcDivision", "CBSACode", "CBSALevel", "CSACode", "MailingLatitude", "MailingLongitude", "MailingCensusKey", "ContactId", "ContactApider", "ContactJobFunctionId", "ContactJobTitles", "ContactJobTitlesCount", "ContactManagementLevel", "ContactProfessionalTitle", "ContactIndicator", "ContactSuppressedFields", "ContactTitleCodes", "Website", "FacebookURL", "TwitterUrl", "LinkedInURL", "YelpUrl", "PinterestUrl", "YoutubeUrl", "TumblrUrl", "FoursquareUrl", "InstagramUrl", "LogoUrl", "WebsiteKeywords", "LocationProfessionalSizeCode", "PlaceType", "AlternativeName", "HistoricalNames", "LegalNames", "BusinessID", "WorkAtHome", "InBusiness", "VerifiedOn", "DuplicateOf", "Suppressed", "SuppressedFields", "CreatedAt", "UpdatedAt", "OpenedForBusinessOn", "EstimatedOpenedForBusiness", "LocationParentId", "LocationParentRelationship", "NumberOfTenants", "BusinessTypeIdsLabels", "ContactsCount", "OwnershipChangedOn", "HeadquartersId", "AncestorHeadquartersIds", "AncestorHeadquartersIdsCount", "UltimateHeadquartersId", "ChainIdLabels", "CorporateFranchising", "CorporateSalesRevenue", "EstimatedCorporateSalesRevenue", "BranchCount", "ForeignParentInd", "FortuneRanking", "StockExchangeCode", "CtockTickerSymbol", "TheCentralIndexKey", "AffiliationIdsLabels", "BrandIdsLabels", "CompanyDescription", "DressCode", "EquipmentRentals", "HasEcommerce", "LanguagesSpoken", "PriceRange", "ProfessionalSpecialty", "PublicAccess", "ShoppingCenterAtm", "OperatingHoursCount", "PaymentTypes", "InsurancesAccepted", "MedicareAccepted", "MedicaidAccepted", "ServiceAreaPostalCodes", "NbrcCorporationFilingType", "NbrcCorporateDate", "CarMakeIdsLabels", "ReligiousDenominationIdsLabels", "RestaurantCuisines", "RestaurantLimitedService", "RestaurantReservations", "RestaurantTakeout", "HappyHoursCount", "HotelCableTV", "HotelContinentalBreakfast", "HotelElevator", "HotelExerciseFacility", "HotelGuestLaundry", "HotelHotTub", "HotelIndoorPool", "HotelKitchens", "HotelOutdoorPool", "HotelPetFriendly", "HotelRoomService", "HospitalHasEmergencyRoom", "EstimatedFleetSizeLower", "EstimatedFleetSizeUpper", "GrowingBusinessGode", "SquareFootage", "WhiteCollarPercentage", "PopulationDensity", "PopulationCodeForZIP", "WealthyAreaInd", "PhysicianYearOfGraduation", "MedicalSchoolCode", "HospitalNumber", "Upin", "LicenseNumber", "StateOfLicense", "PhysicianYearOfBirth", "ResidencyHospitalCode", "ResidencyGraduationYear", "NationalProviderID", "MedicalDeaNumber", "AcceptingNewPatientsIndicator", "PhysicianPrimarySpecialtyCode", "PhysicianSecondarySpecialtyCode", "BoardCertifiedInd", "BusinessID", "FirstName", "LastName", "Apider", "Email", "EmailDeliverableInd", "EmailMarketableInd", "JobTitles", "JobTitlesCount", "ManagementLevelLabels", "TitleCodes", "TitleCodesLabels", "JobFunctionId", "LabelsJobFunctionId", "ProfessionalTitle", "LabelsProfessionalTitle", "PrimaryContactInd" - `OrderBy` (array) Specify the desired column to order the responses by. - `OrderBy.column` (string) - `OrderBy.sortorder` (string) Enum: "ASC", "DESC" ## Response 200 fields (application/json): - `JobId` (string) The JobId to be used to purchase and access the full dataset. - `Count` (integer) Number of records returned by the query. - `ResultCode` (string) Success or Error codes based on the response/request. - `Sample` (array) A 10 record sample response. ## 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.