---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.com/dev/webmaster/doc/en/reference/host-verification-get.md
  - https://yandex.com/dev/webmaster/doc/ru/reference/host-verification-get.md
keywords:
  - с
  - а
  - й
  - т
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/webmaster/doc/ru/llms.txt


# Получение информации о подтверждении сайта

Возвращает информацию о текущем состоянии подтверждения сайта в Яндекс Вебмастере.

## Формат запроса {#request-format}

```
GET https://api.webmaster.yandex.net/v4/user/{[user-id](*user-id)}/hosts/{[host-id](*host-id)}/verification
```

#|
||
`user-id`
|
    
<!-- source: ru/_includes/popup/user-id.md -->
Тип: `int64`. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод [GET /v4/user](https://yandex.com/dev/webmaster/doc/ru/reference/user.md).
<!-- endsource: ru/_includes/popup/user-id.md -->
    
||
||
`host-id`
|
    
<!-- source: ru/_includes/popup/host-id.md -->
Тип: `string`. ID сайта. Чтобы получить его, используйте метод [GET&nbsp;/v4/user/{user&#x2011;id}/hosts](https://yandex.com/dev/webmaster/doc/ru/reference/hosts.md).
<!-- endsource: ru/_includes/popup/host-id.md -->

||
|#

## Формат ответа {#response-format}

### Примеры
> 
> 
> {% list tabs %}
> 
> - JSON
> 
>   
>   ```javascript
>   {
>     "verification_uin": "b01288afe67b1595",
>     "verification_state": "[NONE](*status-verify)",
>     "verification_type": "[META_TAG](*verify-type)",
>     "latest_verification_time": "2016-01-01T00:00:00,000+0300",
>     "fail_info": {
>       "reason": "[META_TAG_NOT_FOUND](*denial-verify)",
>       "message": "explicit error message"
>     },
>     "applicable_verifiers": [
>       "META_TAG", ...
>     ]
>   }
>   ```
>   
> 
> - XML
> 
>   
>   ```xml
>   <Data>
>       <[verification_uin](*verification_uin)>b01288afe67b1595</verification_uin>
>       <[verification_state](*verification_state)>NONE</verification_state>
>       <[verification_type](*verification_type)>META_TAG</verification_type>
>       <[latest_verification_time](*latest_verification_time)>2016-01-01T00:00:00,000+0300</latest_verification_time>
>       <[fail_info](*fail_info)>
>           <[reason](*reason)>META_TAG_NOT_FOUND</reason>
>           <[message](*message)>explicit error message</message>
>       </fail_info>
>       <applicable_verifier>META_TAG</applicable_verifier>
>       ...
>   </Data>
>   ```
> 
> {% endlist %}
> 
> #|
> || **Имя** | **Обязательный** | **Тип** | **Описание** ||
> || `verification_uin` |
> <!-- source: ru/_includes/reference/host-verification-get/verification_uin/req.md -->
> Да
> <!-- endsource: ru/_includes/reference/host-verification-get/verification_uin/req.md -->
> |
> <!-- source: ru/_includes/reference/host-verification-get/verification_uin/type.md -->
> `string`
> <!-- endsource: ru/_includes/reference/host-verification-get/verification_uin/type.md --> 
> |
> Уникальный код подтверждения.
 ||
> || `verification_state` |
> <!-- source: ru/_includes/reference/host-verification-get/verification_state/req.md -->
> Да
> <!-- endsource: ru/_includes/reference/host-verification-get/verification_state/req.md -->
> |
> <!-- source: ru/_includes/reference/host-verification-get/verification_state/type.md -->
> `string` ([ApiVerificationState](https://yandex.com/dev/webmaster/doc/ru/reference/host-verification-get.md#status-verify))
> <!-- endsource: ru/_includes/reference/host-verification-get/verification_state/type.md --> 
> |
> Состояние подтверждения прав.
||
> || `verification_type` | Да
> |
> <!-- source: ru/_includes/reference/host-verification-get/verification_type/type.md -->
> `string` ([ApiVerificationType](https://yandex.com/dev/webmaster/doc/ru/reference/host-verification-get.md#type-verify))
> <!-- endsource: ru/_includes/reference/host-verification-get/verification_type/type.md -->
> |
> Тип подтверждения прав.
||
> || `latest_verification_time` |
> <!-- source: ru/_includes/reference/host-verification-get/latest_verification_time/req.md -->
> Да
> <!-- endsource: ru/_includes/reference/host-verification-get/latest_verification_time/req.md -->
> |
> <!-- source: ru/_includes/reference/host-verification-get/latest_verification_time/type.md -->
> `datetime`
> <!-- endsource: ru/_includes/reference/host-verification-get/latest_verification_time/type.md -->
> |
> Время последней проверки в формате `yyyy-MM-ddTHH:mm:ss,sssZ` (если `verification_state` не равно `NONE`).
 ||
> || `fail_info` |
> {% include [req](../_includes/reference/host-verification-get/fail_info/req.md) %} |  |
> Описание ошибки, если получен статус [`VERIFICATION_FAILED`](#status-verify).
 ||
> || `reason` |
> <!-- source: ru/_includes/reference/host-verification-get/reason/req.md -->
> Да
> <!-- endsource: ru/_includes/reference/host-verification-get/reason/req.md --> 
> |
> <!-- source: ru/_includes/reference/host-verification-get/reason/type.md -->
> `string` ([ApiVerificationFailReason](https://yandex.com/dev/webmaster/doc/ru/reference/host-verification-get.md#denial-verify))
> <!-- endsource: ru/_includes/reference/host-verification-get/reason/type.md -->
> |
> Причина неудачной проверки.
 ||
> || `message` |
> <!-- source: ru/_includes/reference/host-verification-get/message/req.md -->
> Да
> <!-- endsource: ru/_includes/reference/host-verification-get/message/req.md --> 
> |
> <!-- source: ru/_includes/reference/host-verification-get/message/type.md -->
> `string`
> <!-- endsource: ru/_includes/reference/host-verification-get/message/type.md -->
> |
> Описание ошибки для пользователей.
 ||
> || `applicable_verifiers` |
> <!-- source: ru/_includes/reference/host-verification-get/applicable_verifiers/req.md -->
> Да
> <!-- endsource: ru/_includes/reference/host-verification-get/applicable_verifiers/req.md -->
> |
> <!-- source: ru/_includes/reference/host-verification-get/applicable_verifiers/type.md -->
> `string` ([ApiExplicitVerificationType](https://yandex.com/dev/webmaster/doc/ru/reference/host-verification-get.md#type-verify))
> <!-- endsource: ru/_includes/reference/host-verification-get/applicable_verifiers/type.md -->
> |
> Способы подтверждения, применимые для выбранного сайта.
 ||
> |#

<!-- source: ru/_includes/reference/errors/type-verify.md -->
### Способы подтверждения прав (ApiVerificationType) {#type-verify}

#|
||
**Способ подтверждения**
|
**Возможность запроса проверки подтверждения**
|
**Описание**
||
||
`AUTO`
|
Нет
|
Автоматическое подтверждение прав (устаревшее, только для сайтов *.narod.ru).
||
||
`DELEGATED`
|
Нет
|
Права делегированы.
||
||
`DNS`
|
Есть
|
Подтверждение прав с помощью DNS-записи.
||
||
`HTML_FILE`
|
Есть
|
Размещение HTML-файла в корневом каталоге сайта.
||
||
`META_TAG`
|
Есть
|
Добавление метатега в заголовок главной страницы сайта.
||
||
`TXT_FILE`
|
Нет
|
Размещение текстового файла в корневом каталоге сайта.
||
|#
<!-- endsource: ru/_includes/reference/errors/type-verify.md -->

<!-- source: ru/_includes/reference/errors/type-verify-explicit.md -->
### Явные способы подтверждения прав (ApiExplicitVerificationType) {#type-verify-explicit}

#|
||
**Способ подтверждения**
|
**Возможность запроса проверки подтверждения**
|
**Описание**
||
||
`DNS`
|
Есть
|
Подтверждение прав с помощью DNS-записи.
||
||
`HTML_FILE`
|
Есть
|
Размещение HTML-файла в корневом каталоге сайта.
||
||
`META_TAG`
|
Есть
|
Добавление метатега в заголовок главной страницы сайта.
||
|#
<!-- endsource: ru/_includes/reference/errors/type-verify-explicit.md -->

<!-- source: ru/_includes/reference/errors/status-verify.md -->
### Статус подтверждения прав на управление сайтом (ApiVerificationState) {#status-verify}

#|
||
**Статус**
|
**Описание**
||
||
`NONE`
|
Проверка не проводилась, права не подтверждены.
||
||
`VERIFIED`
|
Права подтверждены.
||
||
`IN_PROGRESS`
|
Идет подтверждение прав.
||
||
`VERIFICATION_FAILED`
|
Проверка проводилась, права не подтверждены.
||
||
`INTERNAL_ERROR`
|
В процессе проверки прав произошла непредвиденная ошибка.
||
|#
<!-- endsource: ru/_includes/reference/errors/status-verify.md -->

<!-- source: ru/_includes/reference/errors/denial-verify.md -->
### Причины отказа в подтверждении прав на управление сайтом (ApiVerificationFailReason) {#denial-verify}

#|
||
**Причина отказа**
|
**Описание**
||
||
`DELEGATION CANCELLED`
|
Делегирование прав отменено.
||
||
`DNS_RECORD_NOT_FOUND`
|
Отсутствует указанная DNS-запись.
||
||
`META_TAG_NOT_FOUND`
|
Отсутствует метатег в заголовке главной страницы сайта.
||
||
`WRONG_HTML_PAGE_CONTENT`
|
Содержимое HTML-файла задано неверно.
||
|#
<!-- endsource: ru/_includes/reference/errors/denial-verify.md -->

## Коды ответа {#errors}


Чтобы посмотреть структуру ответа подробнее, нажмите на причину.

#|

||
**Код**
|
**Причина**
|
**Описание**
||


||
200
|
OK
|
||

||
403
|
[INVALID_USER_ID](https://yandex.com/dev/webmaster/doc/ru/reference/errors.md#invalid-user-id)
|
ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже `{user_id}` указан правильный `uid` владельца OAuth-токена.


<!-- source: ru/_includes/reference/errors/code-inv-id.md -->
{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "INVALID_USER_ID",
    "available_user_id": 1,
    "error_message": "Invalid user id. {user_id} should be used."
  }
  ```
  

- XML

  
  ```xml
  <Data>
      <[error_code](*error_code)>INVALID_USER_ID</error_code>
      <[available_user_id](*available_user_id)>1</available_user_id>
      <[error_message](*error_message)>Invalid user id. {user_id} should be used.</error_message>
  </Data>
  ```

{% endlist %}
<!-- endsource: ru/_includes/reference/errors/code-inv-id.md -->

||


||
404
|
[HOST_NOT_FOUND](https://yandex.com/dev/webmaster/doc/ru/reference/errors.md#host-not-found)
|
Сайт отсутствует в списке сайтов пользователя.


<!-- source: ru/_includes/reference/errors/dl-host-not-found.md -->
{% list tabs %}

- JSON

  
  ```javascript
  {
    "error_code": "HOST_NOT_FOUND",
    "host_id": "http:ya.ru:80",
    "error_message": "explicit error message"
  }
  ```
  

- XML

  
  ```xml
  <Data>
      <[error_code](*error_code)>HOST_NOT_FOUND</error_code>
      <[host_id](*host_id)>http:ya.ru:80</host_id>
      <[error_message](*error_message)>explicit error message</error_message>
  </Data>
  ```

{% endlist %}
<!-- endsource: ru/_includes/reference/errors/dl-host-not-found.md -->

||
|#

#### Узнайте больше

- [Коды ошибок и статусы](https://yandex.com/dev/webmaster/doc/ru/reference/errors.md)







[*user-id]: Тип: `int64`. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод [GET /v4/user](https://yandex.com/dev/webmaster/doc/ru/reference/user.md).

[*host-id]: Тип: `string`. ID сайта. Чтобы получить его, используйте метод [GET&nbsp;/v4/user/{user&#x2011;id}/hosts](https://yandex.com/dev/webmaster/doc/ru/reference/hosts.md).

[*verify-type]: ### Способы подтверждения прав (ApiVerificationType) {#type-verify}

#|
||
**Способ подтверждения**
|
**Возможность запроса проверки подтверждения**
|
**Описание**
||
||
`AUTO`
|
Нет
|
Автоматическое подтверждение прав (устаревшее, только для сайтов *.narod.ru).
||
||
`DELEGATED`
|
Нет
|
Права делегированы.
||
||
`DNS`
|
Есть
|
Подтверждение прав с помощью DNS-записи.
||
||
`HTML_FILE`
|
Есть
|
Размещение HTML-файла в корневом каталоге сайта.
||
||
`META_TAG`
|
Есть
|
Добавление метатега в заголовок главной страницы сайта.
||
||
`TXT_FILE`
|
Нет
|
Размещение текстового файла в корневом каталоге сайта.
||
|#

[*status-verify]: 
### Статус подтверждения прав на управление сайтом (ApiVerificationState) {#status-verify}

#|
||
**Статус**
|
**Описание**
||
||
`NONE`
|
Проверка не проводилась, права не подтверждены.
||
||
`VERIFIED`
|
Права подтверждены.
||
||
`IN_PROGRESS`
|
Идет подтверждение прав.
||
||
`VERIFICATION_FAILED`
|
Проверка проводилась, права не подтверждены.
||
||
`INTERNAL_ERROR`
|
В процессе проверки прав произошла непредвиденная ошибка.
||
|#

[*denial-verify]: 
### Причины отказа в подтверждении прав на управление сайтом (ApiVerificationFailReason) {#denial-verify}

#|
||
**Причина отказа**
|
**Описание**
||
||
`DELEGATION CANCELLED`
|
Делегирование прав отменено.
||
||
`DNS_RECORD_NOT_FOUND`
|
Отсутствует указанная DNS-запись.
||
||
`META_TAG_NOT_FOUND`
|
Отсутствует метатег в заголовке главной страницы сайта.
||
||
`WRONG_HTML_PAGE_CONTENT`
|
Содержимое HTML-файла задано неверно.
||
|#

[*verification_uin]: **Обязательный**

<!-- source: ru/_includes/reference/host-verification-get/verification_uin/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-verification-get/verification_uin/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-verification-get/verification_uin/type.md -->
`string`
<!-- endsource: ru/_includes/reference/host-verification-get/verification_uin/type.md -->

**Описание**

<!-- source: ru/_includes/reference/host-verification-get/verification_uin/desc.md -->
Уникальный код подтверждения.
<!-- endsource: ru/_includes/reference/host-verification-get/verification_uin/desc.md -->

[*verification_state]: **Обязательный**

<!-- source: ru/_includes/reference/host-verification-get/verification_state/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-verification-get/verification_state/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-verification-get/verification_state/type.md -->
`string` ([ApiVerificationState](https://yandex.com/dev/webmaster/doc/ru/reference/host-verification-get.md#status-verify))
<!-- endsource: ru/_includes/reference/host-verification-get/verification_state/type.md -->

**Описание**

<!-- source: ru/_includes/reference/host-verification-get/verification_state/desc.md -->
Состояние подтверждения прав.
<!-- endsource: ru/_includes/reference/host-verification-get/verification_state/desc.md -->

[*verification_type]: **Обязательный**

<!-- source: ru/_includes/reference/host-verification-get/verification_type/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-verification-get/verification_type/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-verification-get/verification_type/type.md -->
`string` ([ApiVerificationType](https://yandex.com/dev/webmaster/doc/ru/reference/host-verification-get.md#type-verify))
<!-- endsource: ru/_includes/reference/host-verification-get/verification_type/type.md -->

**Описание**

<!-- source: ru/_includes/reference/host-verification-get/verification_type/desc.md -->
Тип подтверждения прав.
<!-- endsource: ru/_includes/reference/host-verification-get/verification_type/desc.md -->

[*latest_verification_time]: **Обязательный**

<!-- source: ru/_includes/reference/host-verification-get/latest_verification_time/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-verification-get/latest_verification_time/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-verification-get/latest_verification_time/type.md -->
`datetime`
<!-- endsource: ru/_includes/reference/host-verification-get/latest_verification_time/type.md -->

**Описание**

<!-- source: ru/_includes/reference/host-verification-get/latest_verification_time/desc.md -->
Время последней проверки в формате `yyyy-MM-ddTHH:mm:ss,sssZ` (если `verification_state` не равно `NONE`).
<!-- endsource: ru/_includes/reference/host-verification-get/latest_verification_time/desc.md -->

[*fail_info]: **Обязательный**

<!-- source: ru/_includes/reference/host-verification-get/fail_info/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-verification-get/fail_info/req.md -->

**Тип**


**Описание**

<!-- source: ru/_includes/reference/host-verification-get/fail_info/desc.md -->
Описание ошибки, если получен статус [`VERIFICATION_FAILED`](#status-verify).
<!-- endsource: ru/_includes/reference/host-verification-get/fail_info/desc.md -->

[*reason]: **Обязательный**

<!-- source: ru/_includes/reference/host-verification-get/reason/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-verification-get/reason/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-verification-get/reason/type.md -->
`string` ([ApiVerificationFailReason](https://yandex.com/dev/webmaster/doc/ru/reference/host-verification-get.md#denial-verify))
<!-- endsource: ru/_includes/reference/host-verification-get/reason/type.md -->

**Описание**

<!-- source: ru/_includes/reference/host-verification-get/reason/desc.md -->
Причина неудачной проверки.
<!-- endsource: ru/_includes/reference/host-verification-get/reason/desc.md -->

[*message]: **Обязательный**

<!-- source: ru/_includes/reference/host-verification-get/message/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-verification-get/message/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-verification-get/message/type.md -->
`string`
<!-- endsource: ru/_includes/reference/host-verification-get/message/type.md -->

**Описание**

<!-- source: ru/_includes/reference/host-verification-get/message/desc.md -->
Описание ошибки для пользователей.
<!-- endsource: ru/_includes/reference/host-verification-get/message/desc.md -->
{% included (../_includes/reference/host-verification-get/fail_info/req.md) %}
Да

{% endincluded %}