# Index business hits

Returns an array containing all screener hits for a business.

Endpoint: GET /v1/businesses/{business_id}/hits
Version: 1.0

## Path parameters:

  - `business_id` (string, required)

## Response 200 fields (application/json):

  - `id` (string)
    ID of the hit.

  - `status` (string)
    Current status of the hit.

  - `check_phrase` (string)
    check phrase submitted

  - `check_event` (string)
    check initiating event

  - `similarity` (number)
    match percentage to phrase

  - `first_name` (string)
    first name of match

  - `last_name` (string)
    last name of match

  - `threshold` (number)
    threshold of match

  - `aliases_raw` (string)
    match aliases

  - `alternative_spelling` (string)
    match alternate spellings

  - `category` (string)
    match category

  - `title` (string)
    match title

  - `sub_category` (string)
    match subtitle

  - `age` (string)
    match age

  - `date_of_birth` (string)
    YYYY/MM/DD

  - `place_of_birth` (string)
    YYYY/MM/DD

  - `deceased_date` (string)
    YYYY/MM/DD

  - `locations` (string)
    associated location

  - `countries` (string)
    associated countries

  - `companies` (string)
    associated companies

  - `gender` (string)
    gender

  - `further_information` (string)
    further info

  - `keywords` (string)
    keywords

  - `entered` (string)
    date entered in World Checker

  - `updated` (string)
    date updated in World Checker

  - `deleted` (string)
    date deleted in World Checker

  - `passports` (string)
    known passports

  - `position` (string)
    currently held position

  - `remaining_data` (string)
    miscellaneous data

  - `created_at` (string)
    hit created at

  - `updated_at` (string)
    hit updated at

  - `external_sources` (string)
    list of all public sources used

  - `age_recorded_at` (string)
    date when age was recorded

  - `worldcheck_id` (string)
    id of worldcheck entry

## Response 400 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "400"

  - `code` (string)
    Example: "build_pagination_headers_failure"

  - `title` (string)
    Example: "Failed to build pagination headers."

  - `detail` (string)
    Example: "Cannot connect to database."

## Response 403 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "403"

  - `code` (string)
    Example: "unauthorized_action"

  - `title` (string)
    Example: "Unauthorized Action"

  - `detail` (string)
    Example: "Unauthorized action is not allowed."

## Response 404 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "404"

  - `code` (string)
    Example: "model_not_found"

  - `title` (string)
    Example: "Model Not Found"

  - `detail` (string)
    Example: "Couldn't find 'Solaris::Identification' for id 'bbbcccfff388923eb899a5852df6cidt'."

## Response 500 fields (application/json):

  - `id` (string)
    Example: "e8915041-9d8c-4d96-9dd1-04e8522ecdbf"

  - `status` (string)
    Example: "500"

  - `code` (string)
    Example: "generic_error"

  - `title` (string)
    Example: "Generic Error"

  - `detail` (string)
    Example: "There was an error."