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

# Checking the reindexing task status

Returns the status of the reindexing task for the site page.

## Request format

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

#|
||
`user-id`
|
<!-- source: en/_includes/popups.md -->
Type: `int64`. User ID. Required when calling all Yandex.Webmaster API resources. To get it, use the [GET /v4/user](https://yandex.com/dev/webmaster/doc/en/reference/user.md) method.
<!-- endsource: en/_includes/popups.md -->
||
||
`host-id`
|
<!-- source: en/_includes/popups.md -->
Type: `host id (string)`. The site ID. To get it, use the [GET /v4/user/{user-id}/hosts](https://yandex.com/dev/webmaster/doc/en/reference/hosts.md) method.
<!-- endsource: en/_includes/popups.md -->
||
||
`task-id`
|
Type: `UUID`. ID of the reindexing task. To get the ID, use the [GET /v4/user/{user-id}/hosts/{host-id}/recrawl/queue](https://yandex.com/dev/webmaster/doc/en/reference/host-recrawl-get.md) method.
||
|#

## Response format

### Examples

> 
> {% list tabs %}
> 
> - JSON
> 
>   
>   ```javascript
>   {
>     "task_id": "c7fe80c0-36e3-11e6-8b2d-df96aa592c0a",
>     "url": "http://example.com/some/path?a=b",
>     "added_time": "2016-01-01T00:00:00,000+0300",
>     "state": "IN_PROGRESS"
>   }
>   ```
>   
> 
> - XML
> 
>   
>   ```xml
>   <Data> 
>     <[task_id](*task_id)>c7fe80c0-36e3-11e6-8b2d-df96aa592c0a</task_id>  
>     <[url](*url_recrawl)>http://example.com/some/path?a=b</url>  
>     <[added_time](*added_time)>2016-01-01T00:00:00,000+0300</added_time>  
>     <[state](*state_recrawl)>IN_PROGRESS</state>
>   </Data>
>   ```
> 
> {% endlist %}
>
> #|
> || **Name** | **Required** | **Type** | **Description** ||
> || `task_id` | Yes | `string` | ID of the reindexing task. ||
> || `url` | Yes | `string` | The URL of the page sent for reindexing. ||
> || `added_time` | No | `datetime` | Date the reindexing request was created. ||
> || `state` | Yes | `string` ([RecrawlStatusEnum](#recrawl-status-enum)) | The status of the reindexing request. ||
> |#

### Reindexing request status (RecrawlStatusEnum) {#recrawl-status-enum}

#|
|| **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. ||
|#

## Response codes

To view the response structure in detail, click the reason.

#|
||
**Code** | **Reason** | **Description**
||
||
200 | OK | 
||
||
403
|
[INVALID_USER_ID](https://yandex.com/dev/webmaster/doc/en/reference/errors.md#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 %}
||
||
404
|
[HOST_NOT_VERIFIED](https://yandex.com/dev/webmaster/doc/en/reference/errors.md#host-not-verif)
|
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 %}
||
||
404
|
[TASK_NOT_FOUND](https://yandex.com/dev/webmaster/doc/en/reference/errors.md#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 %}
||
|#

### Related information

- [Error codes and statuses](https://yandex.com/dev/webmaster/doc/en/reference/errors.md)




[*user-id]: Type: `int64`. User ID. Required when calling all Yandex.Webmaster API resources. To get it, use the [GET /v4/user](https://yandex.com/dev/webmaster/doc/en/reference/user.md) method.

[*host-id]: Type: `host id (string)`. The site ID. To get it, use the [GET /v4/user/{user-id}/hosts](https://yandex.com/dev/webmaster/doc/en/reference/hosts.md) method.

[*task-id]: Type: UUID. ID of the reindexing task. To get the ID, use the [GET /v4/user/{user-id}/hosts/{host-id}/recrawl/queue](https://yandex.com/dev/webmaster/doc/en/reference/host-recrawl-get.md) method.

[*task_id]: **Required**

Yes

**Type**

`string`

**Description**

ID of the reindexing task.

[*url_recrawl]: **Required**

Yes

**Type**

`string`

**Description**

The URL of the page sent for reindexing.

[*added_time]: **Required**

No

**Type**

`datetime`

**Description**

Date the reindexing request was created.

[*state_recrawl]: **Required**

Yes

**Type**

`string` ([RecrawlStatusEnum](#recrawl-status-enum))

**Description**

The status of the reindexing request.

[*error_code]: **Description**

Error code.

[*available_user_id]: **Description**

ID of the user who allowed access.

[*error_message]: **Description**

Error message.

[*host_id]: **Description**

ID of the requested site.