---
title: "Check if host name is filtered"
method: GET
path: "/filtering/check_host"
tags: ["filtering"]
---

# Check if host name is filtered

`GET /filtering/check_host`

## Request

- Base URL: `/control` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/control/filtering/check_host`
- Auth: HTTP basic

## Query parameters

- `name` string

## Response `200`

OK.

- FilterCheckHostResponse: Check Host Result
  - `reason` 'NotFilteredNotFound' | 'NotFilteredWhiteList' | 'NotFilteredError' | 'FilteredBlackList' | 'FilteredSafeBrowsing' | 'FilteredParental' | 'FilteredInvalid' | 'FilteredSafeSearch' | 'FilteredBlockedService' | 'Rewrite' | 'RewriteEtcHosts' | 'RewriteRule': Request filtering status.
  - `filter_id` integer: In case if there's a rule applied to this DNS request, this is ID of the filter list that the rule belongs to. Deprecated: use `rules[*].filter_list_id` instead.
  - `rule` string: Filtering rule applied to the request (if any). Deprecated: use `rules[*].text` instead.
  - `rules` ResultRule[]: Applied rules.
    - `filter_list_id` integer: In case if there's a rule applied to this DNS request, this is ID of the filter list that the rule belongs to.
    - `text` string: The text of the filtering rule applied to the request (if any).
  - `service_name` string: Set if reason=FilteredBlockedService
  - `cname` string: Set if reason=Rewrite
  - `ip_addrs` string[]: Set if reason=Rewrite

---

[API](https://skmtc.dev/guardllamanet/apis/adguard-home.md) - [All operations](https://skmtc.dev/guardllamanet/apis/adguard-home/llms.txt) - [OpenAPI document](https://skmtc.dev/guardllamanet/apis/adguard-home/revisions/14ff21aeb363?raw)