# Get suppliers Dark Web Mentions

This endpoint will return data and information about Dark Web Mentions of the company suppliers.

Endpoint: GET /v2/dark-web-mentions/suppliers
Version: 2
Security: bearer

## Query parameters:

  - `limit` (number)
    Number of records to return in the response

  - `sortBy` (array)
    Name of the field to sort by

  - `sortDirection` (string)
    The direction of the field sort specified by sort_by
    Enum: "ASC", "asc", "1", "DESC", "desc", "-1"

  - `next_token` (string)
    Token received from a previous request to obtain the next chunk of data

  - `date_range_from` (string)
    A starting date for range filter in the format YYYY-MM-DD (define also 'date_range_to')

  - `date_range_to` (string)
    An ending date for range filter in the format YYYY-MM-DD (define also 'date_range_from')

  - `period` (string)
    Specifies the time range for filtering articles.
    Enum: "LAST_DAY", "LAST_WEEK", "LAST_MONTH", "ALL"

  - `is_alert` (boolean)
    Indicates the filter for alert field of Dark Web Mentions.

  - `supplier_ids` (array)
    Specifies the required suppliers IDs for Dark Web mentions.

## Response 200 fields (application/json):

  - `id` (string)

  - `company_id` (string)

  - `content` (string)

  - `description` (string)

  - `site` (string)

  - `source_type` (string)

  - `date` (string)

  - `apt` (array)

  - `malware` (array)

  - `tags` (array)

  - `domains` (array)

  - `alert_types` (array)

  - `qualified_event` (boolean)

  - `is_alert` (boolean)

  - `type` (string)

  - `creator` (string)

  - `reputation_grade` (number)

  - `site_grade` (number)

  - `price` (string)

  - `language` (string)

  - `module` (array)

  - `link` (string)

  - `has_insight` (boolean)


## Response 401 fields

## Response 403 fields

## Response 429 fields