---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.ru/dev/webmaster/doc/en/reference/errors.md
  - https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/webmaster/doc/en/llms.txt

# Error codes and statuses

## 400 Bad Request

##### {#entity-valid}

{% cut "ENTITY_VALIDATION_ERROR" %}

The request body validation failed.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "ENTITY_VALIDATION_ERROR",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>ENTITY_VALIDATION_ERROR</error_code>  
    <[error_message](*error_message)>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `error_message` | Error message. ||
|#


{% endcut %}

##### {#field-valid}

{% cut "FIELD_VALIDATION_ERROR" %}


Invalid parameter passed.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "FIELD_VALIDATION_ERROR",
    "error_message": "explicit error message",
    "field_name": "some string",
    "field_value": "some string",
    "error_message": "explicit error message"
  }
  ```
  

- XML

  
  ```xml
  <Data>
      <[error_code](*error_code)>FIELD_VALIDATION_ERROR</error_code>
      <[field_name](*field_name)>some string</field_name>
      <[field_value](*field_value)>some string</field_value>
      <[error_message](*error_message)>explicit error message</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `field_name` | Field. ||
|| `field_value` | Value. ||
|| `error_message` | Error message. ||
|#


{% endcut %}

##### {#inv-url}

{% cut "INVALID_URL" %}

Wrong URL was passed.

{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "INVALID_URL",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>INVALID_URL</error_code>  
    <[error_message](*error_message)>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `error_message` | Error message. ||
|#


{% endcut %}

## 403 Forbidden

##### {#access-forb}

{% cut "ACCESS_FORBIDDEN" %}


The action is unavailable because the application doesn't have the necessary permissions.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "ACCESS_FORBIDDEN",
    "error_message": "explicit error message"
  }
  ```
  

- XML

  
  ```xml
  <Data>
      <[error_code](*error_code)>ACCESS_FORBIDDEN</error_code>
      <[error_message](*error_message)>explicit error message</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `error_message` | Error message. ||
|#


{% endcut %}

##### {#inv-oauth-token}

{% cut "INVALID_OAUTH_TOKEN" %}


The OAuth token is missing or invalid.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "INVALID_OAUTH_TOKEN",
    "error_message": "explicit error message"
  }
  ```
  

- XML

  
  ```xml
  <Data>
      <[error_code](*error_code)>INVALID_OAUTH_TOKEN</error_code>
      <[error_message](*error_message)>explicit error message</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `error_message` | Error message. ||
|#


{% endcut %}

##### {#invalid-user-id}

{% cut "INVALID_USER_ID" %}


The ID of the user who issued the token differs from the one specified in the request. In the examples below, `{user_id}` shows the correct `uid` of the OAuth token owner.


{% 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 %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `available_user_id` | ID of the user who allowed access. ||
|| `error_message` | Error message. ||
|#


{% endcut %}


##### {#hosts-limit-exceeded}

{% cut "HOSTS_LIMIT_EXCEEDED" %}


The number of sites in the user's site list exceeded the limit (the current limit is 1703).


{% list tabs %}

- JSON

  
  ```json
  {
   "error_code": "HOSTS_LIMIT_EXCEEDED",
   "limit": 1,
   "error_message": "explicit error message"
  }
  ```
  

- XML

  
  ```xml
  <Data>
      <[error_code](*error_code)>HOSTS_LIMIT_EXCEEDED</error_code>
      <[limit](*limit)>1</limit>
      <[error_message](*error_message)>explicit error message</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `limit` | The limit on the number of added sites. ||
|| `error_message` | Error message. ||
|#


{% endcut %}

## 404 Not Found

##### {#res-not-found}

{% cut "RESOURCE_NOT_FOUND" %}


The resource at the requested path does not exist.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "RESOURCE_NOT_FOUND",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>RESOURCE_NOT_FOUND</error_code>  
    <[error_message](*error_message)>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `error_message` | Error message. ||
|#



{% endcut %}

##### {#host-not-ind}

{% cut "HOST_NOT_INDEXED" %}


The site isn't indexed yet.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "HOST_NOT_INDEXED", //errorCode. 
    "host_id": "http:ya.ru:80", //id хоста. host id. 
    "error_message": "some string" //Error message. 
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>HOST_NOT_INDEXED</error_code>  
    <[host_id](*host_id)>http:ya.ru:80</host_id>  
    <[error_message](*error_message)>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `host_id` | ID of the requested site. ||
|| `error_message` | Error message. ||
|#


{% endcut %}

##### {#host-not-loaded}

{% cut "HOST_NOT_LOADED" %}


The site data isn't uploaded to Yandex.Webmaster yet.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "HOST_NOT_LOADED",
    "host_id": "http:ya.ru:80",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>HOST_NOT_LOADED</error_code>  
    <[host_id](*host_id)>http:ya.ru:80</host_id>
    <[error_message](*error_message)>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `host_id` | ID of the requested site. ||
|| `error_message` | Error message. ||
|#


{% endcut %}

##### {#host-not-verif}

{% cut "HOST_NOT_VERIFIED" %}


Site management rights are not verified.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "HOST_NOT_VERIFIED",
    "host_id": "http:ya.ru:80",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>HOST_NOT_VERIFIED</error_code>  
    <[host_id](*host_id)>http:ya.ru:80</host_id>
    <[error_message](*error_message)>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `host_id` | ID of the requested site. ||
|| `error_message` | Error message. ||
|#


{% endcut %}

##### {#host-not-found}

{% cut "HOST_NOT_FOUND" %}


The site is not in the list of the user's sites.


{% list tabs %}

- JSON

  
  ```json
  {
    "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 %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `host_id` | ID of the requested site. ||
|| `error_message` | Error message. ||
|#


{% endcut %}

##### {#sitemap-not-found}

{% cut "SITEMAP_NOT_FOUND" %}


The Sitemap for the site wasn't found.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "SITEMAP_NOT_FOUND",
    "host_id": "http:ya.ru:80",
    "sitemap_id": "c7-fe:80-c0",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>SITEMAP_NOT_FOUND</error_code> 
    <[host_id](*host_id)>http:ya.ru:80</host_id>  
    <[sitemap_id](*sitemap_id)>c7-fe:80-c0</sitemap_id>  
    <[error_message](*error_message)>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `host_id` | ID of the requested site. ||
|| `sitemap_id` | The `Sitemap` file ID. ||
|| `error_message` | Error message. ||
|#


{% endcut %}

##### {#sitemap-not-added}

{% cut "SITEMAP_NOT_ADDED" %}


The Sitemap file is missing.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "SITEMAP_NOT_ADDED",
    "host_id": "http:ya.ru:80",
    "sitemap_id": "c7-fe:80-c0",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>SITEMAP_NOT_ADDED</error_code> 
    <[host_id](*host_id)>http:ya.ru:80</host_id>  
    <[sitemap_id](*sitemap_id)>c7-fe:80-c0</sitemap_id>  
    <[error_message](*error_message)>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
||**Parameter** | **Description** ||
||`error_code` | Error code. ||
||`host_id` | ID of the requested site. ||
||`sitemap_id` | The `Sitemap` file ID. ||
||`error_message` | Error message. ||
|#


{% endcut %}

##### {#task-not-found}

{% cut "TASK_NOT_FOUND" %}


Failed to find a task with the specified ID.


{% list tabs %}

- JSON

  
  ```javascript
  {
    "error_code": "TASK_NOT_FOUND",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>TASK_NOT_FOUND</error_code>  
    <[error_message](*error_message)>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `error_message` | Error message. ||
|#


{% endcut %}

##### {#query-id-not-found}

{% cut "QUERY_ID_NOT_FOUND" %}


The specified search query ID does not exist.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "QUERY_ID_NOT_FOUND",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>QUERY_ID_NOT_FOUND</error_code>  
    <[error_message](*error_message)>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `error_message` | Error message. ||
|#


{% endcut %}

## 405 Method Not Allowed

The HTTP method is not supported for this resource.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "METHOD_NOT_ALLOWED",
    "error_message": "explicit error message"
  }
  ```
  

- XML

  
  ```xml
  <Data>
      <[error_code](*error_code)>METHOD_NOT_ALLOWED</error_code>
      <[error_message](*error_message)>explicit error message</error_message>
  </Data>
  ```

{% endlist %}


#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `error_message` | Error message. ||
|#


## 406 Not Acceptable

The content types passed in the Accept header are not supported.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "CONTENT_TYPE_UNSUPPORTED",
    "acceptable_types": [
      "some string", ...
    ],
    "error_message": "explicit error message"
  }
  ```
  

- XML

  
  ```xml
  <Data>
      <[error_code](*error_code)>CONTENT_TYPE_UNSUPPORTED</error_code>
      <[acceptable_type](*acceptable_type)>some string</acceptable_type>
      ...
      <[error_message](*error_message)>explicit error message</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `acceptable_type` | List of supported content types. ||
|| `error_message` | Error message. ||
|#

## 409 Conflict

##### {#url-already-edded}

{% cut "URL_ALREADY_ADDED" %}


The URL was already added for reindexing.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "URL_ALREADY_ADDED",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>URL_ALREADY_ADDED</error_code>  
    <[error_message](*error_message)>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `error_message` | Error message. ||
|#


{% endcut %}

##### {#host-already-added}

{% cut "HOST_ALREADY_ADDED" %}


The site with the specified address is already added to the user's sites list.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "HOST_ALREADY_ADDED",
    "host_id": "http:ya.ru:80",
    "verified": false,
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <error_code>HOST_ALREADY_ADDED</error_code> 
    <host_id>http:ya.ru:80</host_id> 
    <verified>false</verified> 
    <error_message>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `host_id` | The site ID. ||
|| `verified` | Indicates if the site rights are verified. ||
|| `error_message` | Error message. ||
|#


{% endcut %}

##### {#verif-in-progress}

{% cut "VERIFICATION_ALREADY_IN_PROGRESS" %}


The rights verification process is in progress.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "VERIFICATION_ALREADY_IN_PROGRESS",
    "verification_type": "META_TAG",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <error_code>VERIFICATION_ALREADY_IN_PROGRESS</error_code>  
    <verification_type>META_TAG</verification_type> 
    <error_message>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `verification_type` | The verification method being processed ([ApiExplicitVerificationType](https://yandex.ru/dev/webmaster/doc/en/reference/host-verification-post.md#verification-type-explicit)). ||
|| `error_message` | Error message. ||
|#


{% endcut %}

##### {#text-already-added}

{% cut "TEXT_ALREADY_ADDED" %}


The text you added earlier.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "TEXT_ALREADY_ADDED",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <error_code>TEXT_ALREADY_ADDED</error_code>  
    <error_message>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `error_message` | Error message. ||
|#



{% endcut %}

##### {#sitemap-already-added}

{% cut "SITEMAP_ALREADY_ADDED" %}


The Sitemap was already added.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "SITEMAP_ALREADY_ADDED",
    "sitemap_id": "c7-fe:80-c0",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <error_code>SITEMAP_ALREADY_ADDED</error_code> 
    <sitemap_id>c7-fe:80-c0</sitemap_id>  
    <error_message>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `sitemap_id` | The `Sitemap` file ID. ||
|| `error_message` | Error message. ||
|#


{% endcut %}

## 410 Gone

Resource unavailable


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "UPLOAD_ADDRESS_EXPIRED",
    "valid_until": "2016-01-01T00:00:00,000+0300",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <error_code>UPLOAD_ADDRESS_EXPIRED</error_code>
    <valid_until>2016-01-01T00:00:00,000+0300</valid_until>
    <error_message>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `valid_until` | The date and time until which the URL for task creation is available. ||
|| `error_message` | Error message. ||
|#

## 413 Payload Too Large

The file size exceeds the limits.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "REQUEST_ENTITY_TOO_LARGE",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <error_code>REQUEST_ENTITY_TOO_LARGE</error_code>
    <error_message>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `error_message` | Error message. ||
|#

## 415 Unsupported Media Type


{% cut "CONTENT_TYPE_UNSUPPORTED" %}


The content type in the request is not supported.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "CONTENT_TYPE_UNSUPPORTED",
    "supported_content_types": [
      "some string", ...
    ],
    "error_message": "explicit error message"
  }
  ```
  

- XML

  
  ```xml
  <Data>
      <error_code>CONTENT_TYPE_UNSUPPORTED</error_code>
      <supported_content_type>some string</supported_content_type>
      ...
      <error_message>explicit error message</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `supported_content_type` | List of supported content types. ||
|| `error_message` | Error message. ||
|#



{% endcut %}

{% cut "CONTENT_ENCODING_UNSUPPORTED" %}


The request encoding type is not supported.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "CONTENT_ENCODING_UNSUPPORTED",
    "supported_content_encodings": [
      "some string"
    ],
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <error_code>CONTENT_ENCODING_UNSUPPORTED</error_code> 
    <supported_content_encoding>some string</supported_content_encoding>  
    <error_message>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `supported_content_encoding` | List of supported encoding types. ||
|| `error_message` | Error message. ||
|#



{% endcut %}

## 422 Unprocessable Entity

The passed text is too short or too long.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "TEXT_LENGTH_CONSTRAINTS_VIOLATION",
    "max_length": 1,
    "min_length": 1,
    "actual_length": 1,
    "error_message": "explicit error message"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <error_code>TEXT_LENGTH_CONSTRAINTS_VIOLATION</error_code>
      <max_length>1</max_length>
      <min_length>1</min_length>
      <actual_length>1</actual_length>
    <error_message>explicit error message</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `max_length` | Maximum length. ||
|| `min_length` | Minimum length. ||
|| `actual_length` | The length of the text in the request. ||
|| `error_message` | Error message. ||
|#

## 429 Too Many Requests

##### {#quota-exc}

{% cut "QUOTA_EXCEEDED" %}


The daily quota for requests was exceeded.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "QUOTA_EXCEEDED",
    "daily_quota": 1,
    "exceeded_until": "2016-01-01T00:00:00,000+0300",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <error_code>QUOTA_EXCEEDED</error_code>  
    <daily_quota>1</daily_quota>  
    <exceeded_until>2016-01-01T00:00:00,000+0300</exceeded_until>  
    <error_message>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `daily_quota` | The maximum number of requests per day. ||
|| `exceeded_until` | Time when the new quota starts. ||
|| `error_message` | Error message. ||
|#

{% endcut %}

##### {#too-many-req}

{% cut "TOO_MANY_REQUESTS_ERROR" %}


Too many requests sent.


{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "TOO_MANY_REQUESTS_ERROR",
    "daily_quota": 1,
    "exceeded_until": "2016-01-01T00:00:00,000+0300",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <error_code>TOO_MANY_REQUESTS_ERROR</error_code>  
    <daily_quota>1</daily_quota>  
    <exceeded_until>2016-01-01T00:00:00,000+0300</exceeded_until>  
    <error_message>some string</error_message>
  </Data>
  ```

{% endlist %}

#|
|| **Parameter** | **Description** ||
|| `error_code` | Error code. ||
|| `daily_quota` | The maximum number of requests per day. ||
|| `exceeded_until` | Time when the new quota starts. ||
|| `error_message` | Error message. ||
|#


{% endcut %}

## The status of verifying the right to manage the site (ApiVerificationState)

#|
|| **Status** | **Description** ||
|| `NONE` | Verification wasn't completed and rights are not confirmed. ||
|| `VERIFIED` | The rights are verified. ||
|| `IN_PROGRESS` | The rights verification is in progress. ||
|| `VERIFICATION_FAILED` | Verification was performed but rights are not confirmed. ||
|| `INTERNAL_ERROR` | An unexpected error occurred when verifying the rights. ||
|#

## Rights verification methods (ApiVerificationType)

#|
|| **Verification method** | **Whether a verification check can be requested** | **Description** ||
|| `AUTO` | No | Automatic rights verification (deprecated; only for *.narod.ru sites). ||
|| `DELEGATED` | No | Rights were delegated. ||
|| `DNS` | Yes | Verifying rights with the DNS record. ||
|| `HTML_FILE` | Yes | Placing an HTML file in the site's root directory. ||
|| `META_TAG` | Yes | Adding a meta tag to the site's home page header. ||
|| `PDD` | No | Rights verification via Yandex.Mail for Domains. ||
|| `TXT_FILE` | No | Placing a text file in the site's root directory. ||
|#


<!-- source: en/_includes/reference/api-explicit-verification-type.md -->
### Explicit methods of rights verification (ApiExplicitVerificationType) {#api-verification-type-explicit}

#|
||
**Verification method** | **Whether a verification check can be requested** | **Description**
||
||
`DNS` | Yes | Verifying rights with the DNS record.
||
||
`HTML_FILE` | Yes | Placing an HTML file in the site's root directory.
||
||
`META_TAG` | Yes | Adding a meta tag to the site's home page header.
||
|#
<!-- endsource: en/_includes/reference/api-explicit-verification-type.md -->


## Reasons for refusal to verify site management rights (ApiVerificationFailReason)

#|
|| **Reason for refusal** | **Description** ||
|| `DELEGATION CANCELLED` | Delegation of site management rights was canceled. ||
|| `DNS_RECORD_NOT_FOUND` | The specified DNS record doesn't exist. ||
|| `META_TAG_NOT_FOUND` | The meta tag is missing in the site's home page header. ||
|| `PDD_VERIFICATION_CANCELLED` | Verification of site management rights via Yandex.Mail for Domain isn't allowed for this site. ||
|| `WRONG_HTML_PAGE_CONTENT` | The HTML file content is set incorrectly. ||
|#

## Source of the Sitemap file (ApiSitemapSource)

#|
|| **Source** | **Description** ||
|| `ROBOTS_TXT` | Sitemap is specified in the site's `robots.txt` file. ||
|| `WEBMASTER` | The user added the Sitemap in Yandex.Webmaster. ||
|| `INDEX_SITEMAP` | Sitemap found in another (index) `Sitemap` file. ||
|#

## Type of Sitemap file (ApiSitemapType)

#|
|| **Type** | **Description** ||
|| `SITEMAP` | Normal `Sitemap` file that contains the URLs of site pages. ||
|| `INDEX_SITEMAP` | The `Sitemap` index file that contains the URLs of other `Sitemap` files. ||
|#

## Site indexing status (ApiHostDataStatus)

#|
|| **Source** | **Description** ||
|| `NOT_INDEXED` | The site isn't indexed yet. ||
|| `NOT_LOADED` | The site data isn't uploaded to Yandex.Webmaster yet. ||
|| `OK` | The site is indexed. The data is available in Yandex.Webmaster. ||
|#

## Indexing indicators (ApiIndexingIndicator)

#|
|| **Indicator** | **Description** ||
|| `SEARCHABLE` | Pages in the search. ||
|| `DOWNLOADED` | Downloaded pages. ||
|| `DOWNLOADED_2XX` | Pages downloaded with a 2XX code. ||
|| `DOWNLOADED_3XX` | Pages downloaded with a 3XX code. ||
|| `DOWNLOADED_4XX` | Pages downloaded with a 4XX code. ||
|| `DOWNLOADED_5XX` | Pages downloaded with a 5XX code. ||
|| `FAILED_TO_DOWNLOAD` | Failed to download. ||
|| `EXCLUDED` | Excluded pages. ||
|| `EXCLUDED_DISALLOWED_BY_USER` | Excluded at the request of the resource owner (4XX codes or prohibited in `robots.txt`). ||
|| `EXCLUDED_SITE_ERROR` | Excluded due to a site error. ||
|| `EXCLUDED_NOT_SUPPORTED` | Excluded as not supported by the Yandex robots. ||
|#

## Query indicators (ApiQueryIndicator)

#|
|| **Indicator** | **Description** ||
|| `TOTAL_SHOWS` | The number of displays. ||
|| `TOTAL_CLICKS` | The number of clicks. ||
|| `AVG_SHOW_POSITION` | The average position of the display. ||
|| `AVG_CLICK_POSITION` | Average click position. ||
|#

## Query sorting order (ApiQueryOrderField)

#|
|| **Indicator** | **Description** ||
|| `TOTAL_SHOWS` | The number of displays. ||
|| `TOTAL_CLICKS` | The number of clicks. ||
|#

## Device type indicators (ApiDeviceTypeIndicator)

#|
|| **Indicator** | **Description** ||
|| `ALL` | All device types. ||
|| `DESKTOP` | Computers. ||
|| `MOBILE_AND_TABLET` | Mobile phones and tablets. ||
|| `MOBILE` | Mobile phones. ||
|| `TABLET` | Tablets. ||
|#


If the request does not specify a device type indicator, the default value is `ALL`.
## Indicators of external links (ApiExternalLinksIndicator)

#|
|| **Indicator** | **Description** ||
|| `LINKS_TOTAL_COUNT` | The total number of known external links to the host. ||
|#

## Internal link indicators (ApiInternalLinksBrokenIndicator)

#|
|| **Indicator** | **Description** ||
|| `SITE_ERROR` | The total number of known external links to the site. ||
|| `DISALLOWED_BY_USER` | The page doesn't exist or [is prohibited from indexing](https://yandex.com/support/webmaster/adding-site/indexing-prohibition.html). ||
|| `UNSUPPORTED_BY_ROBOT` | Not supported by the main Search indexing robot. ||
|#

## Reindexing request status (RecrawlStatusEnum)

#|
|| **Indicator** | **Description** ||
|| `IN_PROGRESS` | The request is being processed. ||
|| `DONE` | The robot crawled the URL ||
|| `FAILED` | The robot failed to crawl the page. [Make sure](https://webmaster.yandex.com/tools/server-response/) it is accessible to the robot and the server responds fast enough. ||
|#

## Issue categories on the site (SiteProblemSeverityEnum)

#|
||
**Indicator** | **Description** | **Note**
||
||
`FATAL`
|
Fatal errors. Checks the server connection, site availability for indexing, security and compliance with [Yandex guidelines](https://yandex.ru/company/rules/optimization/).
|
This may lead to excluding individual pages or the entire site from search results.

We recommend monitoring these errors and fixing them as soon as possible.
||
||
`CRITICAL`
|
Critical issues. Checks the presence and validity of the SSL certificate, the number of broken internal links, and the server response time.
|
This may lead to excluding individual pages or the entire site from search results.

We recommend monitoring these errors and fixing them as soon as possible.
||
||
`POSSIBLE_PROBLEM`
|
Possible issues. Checks the [Sitemap](https://yandex.com/support/webmaster/controlling-robot/sitemap.html) and [robots.txt](https://yandex.com/support/webmaster/controlling-robot/robots-txt.html) file validity, settings for displaying non-existent files, the number of duplicate pages, the presence of redirects, annoying ads, and so on.
|
May affect the quality and speed of site indexing.
||
||
`RECOMMENDATION`
|
Recommendations. Usually includes suggestions for improving the site's ranking in search results.
|
Use them to improve the site's ranking in search results.
||
|#

## State of the issue (ApiSiteProblemState)

#|
|| **Indicator** | **Description** ||
|| `PRESENT` | Present on the site. ||
|| `ABSENT` | Missing. ||
|| `UNDEFINED` | Not enough data to determine if there are issues. ||
|#

## Type of site issue (ApiSiteProblemTypeEnum)

#|
|| **Indicator** | **Description** ||
|| **FATAL** | > ||
|| DISALLOWED_IN_ROBOTS | The site is prohibited for indexing in the `robots.txt` file. ||
|| DNS_ERROR | Failed to connect to the server due to a DNS error. ||
|| MAIN_PAGE_ERROR | The site's home page returns an error. ||
|| THREATS | Security threats or issues were detected. ||
|| **CRITICAL** | > ||
||
SLOW_AVG_RESPONSE_TIME
|
Slow server response. For more information, see this [Help section](https://yandex.com/support/webmaster/diagnosis/critical.html#diagnostics-critical__request).
||
||
SSL_CERTIFICATE_ERROR
|
Invalid SSL certificate settings. For more information, see this [Help section](https://yandex.com/support/webmaster/diagnosis/critical.html#diagnostics-critical__ssl).
||
|| **POSSIBLE_PROBLEM** | > ||
|| BAD_ADVERTISEMENT | Ad formats do not comply with IAB Russia recommendations. ||
|| DOCUMENTS_MISSING_DESCRIPTION | Many pages do not have the Description meta tag. ||
|| DOCUMENTS_MISSING_TITLE | The `title` element is missing on many pages. ||
|| ERROR_IN_ROBOTS_TXT | Errors in the `robots.txt` file. ||
|| ERRORS_IN_SITEMAPS | Errors found in the `Sitemap` file. ||
||
MAIN_MIRROR_IS_NOT_HTTPS
|
The site's main mirror doesn't use the HTTPS protocol We recommend using the HTTPS protocol. For more information and instructions on switching protocols, see the [Help](https://yandex.com/support/webmaster/yandex-indexing/https-migration.html).
||
|| MAIN_PAGE_REDIRECTS | The main page redirects to another site. ||
|| NO_METRIKA_COUNTER_CRAWL_ENABLED | Site crawling using Yandex.Metrica tags isn't enabled. For more information about site indexing using the Yandex.Metrica tag, see the [Help](https://yandex.com/support/webmaster/indexing-options/link-metrica.html). ||
|| NO_ROBOTS_TXT | The `robots.txt` file wasn't found. ||
|| NO_SITEMAPS | The `Sitemap` files used by the robot are missing. ||
|| NO_SITEMAP_MODIFICATIONS | The `Sitemap` files haven't been updated for a long time. ||
|| NON_WORKING_VIDEO | The robot failed to index videos on the site. ||
|| SOFT_404 | The display of non-existent files and pages is configured incorrectly. ||
|| TOO_MANY_DOMAINS_ON_SEARCH | The site subdomains are found in the search results. ||
|| TOO_MANY_PAGE_DUPLICATES | Too many duplicate pages. ||
|| **RECOMMENDATION** | > ||
||
FAVICON_PROBLEM
|
The `favicon` file was not found. The robot failed to load an image file to display in the browser tab and next to the site name in the search results. For more information about this error and how to fix it, see the [help section](https://yandex.com/support/webmaster/search-results/favicon.html).
||
|| INCOMPLETE_SPRAV_COMPANY_PROFILE | Yandex.Directory contains incomplete information about the organization. ||
|| NO_CHATS | [Chats on Search](https://tech.yandex.ru/dialogs/chats/doc/index-docpage/) are missing. ||
|| NO_METRIKA_COUNTER | Yandex.Metrica tag error ||
|| NO_REGIONS | The site region isn't set. ||
|| NOT_IN_SPRAV | The site isn't registered in Yandex.Directory. ||
|| NOT_MOBILE_FRIENDLY | The site isn't optimized for mobile devices. ||
|#

## HTTP status codes received by the robot during indexing (IndexingStatusEnum)

#|
||
**Indicator** | **Description**
||
||
`HTTP_2XX`

`HTTP_3XX`

`HTTP_4XX`

`HTTP_5XX`
|
For more information about statuses, see the [help section](https://yandex.com/support/webmaster/error-dictionary/http-codes.html).
||
||
`OTHER`
|
Unsupported HTTP code, connection error, or other error.
||
|#

## Site page status in search results (ApiSearchEventEnum)

#|
|| **Indicator** | **Description** ||
|| `APPEARED_IN_SEARCH` | The page appeared in search results. ||
|| `REMOVED_FROM_SEARCH` | The page was removed from search results. ||
|#

## Changes to important pages in the search (ApiImportantUrlChangeIndicator)

#|
|| **Indicator** | **Description** ||
|| `INDEXING_HTTP_CODE` | The HTTP response code received by the robot when crawling the page changed. ||
|| `SEARCH_STATUS` | The page status in the search changed (it was added or removed). ||
|| `TITLE` | The page title changed. ||
|| `DESCRIPTION` | The [Description meta tag](https://yandex.com/support/webmaster/indexing-options/description.html#description) content changed. ||
|#

## Reasons for excluding the page from search results (ApiExcludedUrlStatus)


#|
||
**Indicator** | **Description**
||
||
`NOTHING_FOUND` | The robot doesn't know about the page, or it was unavailable for a long time. [Submit the page for reindexing](https://webmaster.yandex.com/site/indexing/reindex/).
||
||
`HOST_ERROR` | When trying to access the site, the robot could not connect to the server. Check the server response and make sure that the Yandex robot isn't blocked by the hosting provider. The site is indexed automatically when it becomes available for the robot. For information about the user agent robots, see the [help section](https://yandex.com/support/webmaster/robot-workings/check-yandex-robots.html).
||
||
`REDIRECT_NOTSEARCHABLE` | The page redirects to another page. The target page is indexed (RedirectTarget). Check the indexing of the target page.
||
||
`HTTP_ERROR` | An error occurred when accessing the “HTTP error” page. [Check the server response](https://webmaster.yandex.com/tools/server-response/). If the problem persists, contact your site administrator or the server administrator. If the page is already available, submit it for reindexing.
||
||
`NOT_CANONICAL` | The page is indexed by the canonical URL specified in the [rel="canonical"](https://yandex.com/support/webmaster/controlling-robot/html.html#canonical) attribute in its source code. Correct or delete the attribute if it is specified incorrectly. The robot will track the changes automatically.
||
||
`NOT_MAIN_MIRROR` | The page belongs to a secondary [site mirror](https://yandex.com/support/webmaster/yandex-indexing/site-mirrors.html), so it was excluded from the search.
||
||
`PARSER_ERROR` | When trying to access the page, the robot couldn't get its content. [Check the server response](https://webmaster.yandex.com/tools/server-response/) or the presence of prohibiting HTML elements. If the problem persists, contact your site administrator or the server administrator. If the page is already available, [send it for reindexing](https://webmaster.yandex.com/site/indexing/reindex/).
||
||
`ROBOTS_HOST_ERROR` | Site indexing is prohibited in the `robots.txt` file. The robot will automatically start crawling the page when the site becomes available for indexing.
||
||
`ROBOTS_URL_ERROR` | Page indexing is prohibited in the [robots.txt](https://yandex.com/support/webmaster/controlling-robot/robots-txt.html) file. The robot will automatically crawl the page when it becomes available for indexing.
||
||
`DUPLICATE` | The page duplicates a site page that is already in the search. For more information, see the [help section](https://yandex.com/support/webmaster/robot-workings/double.html).
||
||
`LOW_QUALITY` | The page has been removed from search results due to low quality as determined by a special algorithm. If the algorithm finds the page relevant to users' search queries, it will appear in the search automatically.
||
||
`CLEAN_PARAMS` | The page was excluded from the search after the robot processed the [Clean-param](https://yandex.com/support/webmaster/controlling-robot/robots-txt.html#clean-param) directive. To get the page indexed, edit the `robots.txt` file.
||
||
`NO_INDEX` | The page is excluded because the [robots meta tag has the noindex value](https://yandex.com/support/webmaster/controlling-robot/html.html).
||
||
`OTHER` | The robot does not have updated data for the page.

[Check the server response](https://webmaster.yandex.com/tools/server-response/) or the presence of prohibiting [HTML elements](https://yandex.com/support/webmaster/adding-site/indexing-prohibition.html#indexing-prohibition__content).

If the page can't be accessed by the robot, contact the administrator of your site or server. If the page is already available, [send it for reindexing](https://webmaster.yandex.com/site/indexing/reindex/).
||
|#


## Status of the RSS feed upload task (LoadStatus)

#|
|| **Indicator** | **Description** ||
|| `PROCESSING` | The file is checked for errors. ||
|| `OK` | The file is loaded and it doesn't contain errors. ||
|| `WARNING` | XML elements in the file aren't supported by Yandex or are specified incorrectly. ||
|| `ERROR` | The file contains errors (for example, duplicate XML elements). ||
|#




[*error_code]: **Description**

Error code.

[*error_message]: **Description**

Error message.

[*field_name]: **Description**

Field.

[*field_value]: **Description**

Value.

[*available_user_id]: **Description**

ID of the user who allowed access.

[*limit]: **Description**

The limit on the number of added sites.

[*host_id]: **Description**

ID of the requested site.

[*sitemap_id]: **Description**

The `Sitemap` file ID.

[*acceptable_type]: **Description**

List of supported content types.