> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/safebrowsing/doc/en/llms.txt

# Get Safe Browsing lists

The request returns information about the up-to-date Yandex-hosted Safe Browsing lists.

Safe Browsing lists consist of variable length SHA-256 hash prefixes (from 4 to 32 bytes) mapped to URLs of internet resources that pose threats to users. Each list is identified by the following parameters:
- [Type of alleged threat](*Type-of-alleged-threat)
- [Platform susceptible to threat](*Platform-susceptible-to-threat)
- [Type of object posing a threat](*Type-of-object-posing-a-threat)

Lists are generated and supported by Yandex. To learn about computing hashes, see [URL and hashing](https://yandex.com/dev/safebrowsing/doc/en/concepts/url-hash.md).

## Request format {#request-format}
```
GET https://sba.yandex.net/v4/threatLists
  ? [key](*key)=<API key>
```


#|
||
##key##[*](*requiredParam)
|

[API key](https://yandex.com/dev/safebrowsing/doc/en/concepts/restricts.md) value.

||
|#

\* Required

The response format is shown below. The sequence and presence of elements is not guaranteed. The response may contain auxiliary parameters not described in this document.


## Response format {#response-body}

The response body contains a list of all up-to-date Safe Browsing lists with the parameters that identify each of them.

The resulting values are used in the request parameters:

- [Lookup. URL-based check](https://yandex.com/dev/safebrowsing/doc/en/concepts/lookup.md).
- [Update. Update local Safe Browsing database](https://yandex.com/dev/safebrowsing/doc/en/concepts/update-threatlist.md).
- [Update. Hash-based check](https://yandex.com/dev/safebrowsing/doc/en/concepts/update-fullhashes-find.md).

```json
{
  "[threatLists](*threatLists)": [
    { 
      "[threatType](*threatType)": "{еnum}",
      "[platformType](*platformType)": "{еnum}",
      "[threatEntryType](*threatEntryType)": "{еnum}"
    }
  ]
}
```

{% include notitle [threatLists](../_includes/params.md#threatLists) %}

 
:   {% include notitle [threatType](../_includes/params.md#threatType) %}

    {% include notitle [platformType](../_includes/params.md#platformType) %}

    {% include notitle [threatEntryType](../_includes/params.md#threatEntryType) %}

\* Required

## Example {#example}

Request:

```httpget
https://sba.yandex.net/v4/threatLists?key=2f8...8ea
```

Response:

```json
{
  "[threatLists](*threatLists)": [
    {
      "[threatType](*threatType)": "MALWARE",
      "[platformType](*platformType)": "WINDOWS",
      "[threatEntryType](*threatEntryType)": "URL"
    },
    {
      "[threatType](*threatType)": "MALWARE",
      "[platformType](*platformType)": "LINUX",
      "[threatEntryType](*threatEntryType)": "URL"
    }
  ]
}
```
{% include notitle [table-style-none.md](../_includes/table-style-none.md) %}

[*Type-of-object-posing-a-threat]: Possible values:
- `THREAT_ENTRY_TYPE_UNSPECIFIED`: The threat type is unknown.
    
- `URL`: A URL address.
    
- `EXECUTABLE`: An executable program.

[*Type-of-alleged-threat]: Possible values:
- `THREAT_TYPE_UNSPECIFIED`: An unknown type of threat.
    
- `MALWARE`: Malicious software.
    
- `SOCIAL_ENGINEERING`: A threat related to social engineering.
    
- `UNWANTED_SOFTWARE`: Unwanted software.
    
- `POTENTIALLY_HARMFUL_APPLICATION`: An application that may pose a threat.

[*Platform-susceptible-to-threat]: Possible values:
- `PLATFORM_TYPE_UNSPECIFIED`: An unknown platform.
    
- `WINDOWS`: A Windows operating system.
    
- `LINUX`: A Linux operating system.
    
- `ANDROID`: An Android operating system.
    
- `OSX`: An OS X operating system.
    
- `IOS`: An iOS operating system.
    
- `ANY_PLATFORM`: At least one platform from the list.
    
- `ALL_PLATFORMS`: All platforms.
    
- `CHROME`: A Chrome platform.

[*key]: [API key](https://yandex.com/dev/safebrowsing/doc/en/concepts/restricts.md) value.

[*requiredParam]: \* Required

[*threatLists]:
    {% include notitle [threatLists](../_includes/popups.md#threatLists) %}

[*threatType]:
    {% include notitle [threatType](../_includes/popups.md#threatType) %}

[*platformType]:
    {% include notitle [platformType](../_includes/popups.md#platformType) %}

[*threatEntryType]:
    {% include notitle [threatEntryType](../_includes/popups.md#threatEntryType) %}