# Get record count and sample of addresses

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 /MAK/getCount

## 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.RBDI` (array)
    An RBDI code.

  - `Excludes` (object)
    Any parameter you would like to exclude in the query.

  - `Columns` (array, required)
    All [MAK Columns](https://docs.melissa.com/reference-data/data-retriever/data-retriever-reference-guide.html#mak) you want returned.
    Enum: "MelissaAddressKey", "BaseMelissaAddressKey", "AddressLine", "Suite", "Urbanization", "City", "State", "AddressKey", "BaseRecord", "ResultCodes", "AddressStreetNumber", "AddressDirectionPrefix", "AddressStreetName", "AddressStreetSuffix", "AddressDirectionSuffix", "AddressSuiteName", "AddressSuiteNumber", "AddressType", "RBDI", "CommercialMailReceivingAgency", "County", "CongressionalDistrict", "CarrierRoute", "CityAbbreviation", "FIPSCode", "Vacant", "NeighborhoodName", "ApartmentName", "NonUSPS", "PlaceCode", "Latitude", "Longitude", "GeoLevel", "CensusKey", "CensusKeyDecennial", "ElevationInMeters"

## 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.$.<PropertyName>` (array)
    A detailed message about the error.

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