# Query task status

Read the status summary of the export task.

```text
GET https://moi.matrixorigin.cn/newmoi/export/task/$TASK_ID/state
```

## Preparation before calling

First [Query task details](get-export-task.md) to confirm the export task whose status you want to view. Prepare a personal access token with access to the target workspace, the target workspace ID, and the export task ID.

The example below uses:

- `$AI_STUDIO_API_KEY`: The actual personal access token, passed through the `X-API-Key` Header.
- `$WORKSPACE_ID`: Target workspace ID, passed through `X-Workspace-ID` Header.
- `$TASK_ID`: To view the status of the exported task ID, fill in the task ID position in the request address.

## Request example

```bash
curl "https://moi.matrixorigin.cn/newmoi/export/task/$TASK_ID/state" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"
```

## Path parameters

| Parameters | Type | Is it required | Description |
| --- | --- | --- | --- |
| `task_id` | string | Yes | The export task ID whose status is to be queried. |

## Successful response

Returns `200` on success. `data` only provides an aggregate count of file processing status; `pending`, `running` and `failed` must be checked, HTTP success cannot be considered export completion.

```json
{
  "code": "OK",
  "msg": "OK",
  "data": {
    "total": 4,
    "pending": 0,
    "running": 1,
    "failed": 1,
    "completed": 2
  }
}
```

The response fields are as follows.

| Field | Type | Description |
| --- | --- | --- |
| `code` | string | `OK` on success. |
| `msg` | string | `OK` on success. |
| `data.total` | integer | The total number of files in the task. |
| `data.pending` | integer | Number of files to be processed. |
| `data.running` | integer | The number of files being exported. |
| `data.failed` | integer | The number of files that failed to export. |
| `data.completed` | integer | Number of files that have been successfully completed. |

## Error response

```json
{
  "code": "ErrServer",
  "msg": "Internal server error",
  "data": null
}
```

### Common HTTP errors

```{list-table}
:header-rows: 1
:widths: 12 24 36 28

* - HTTP status code
  - error code
  - Common causes
  - Recommended actions
* - `200`
  - `ErrServer`
  - The task does not exist or the status statistics reading fails.
  - Check `task_id` and try again.
* - `403`
  - `ErrForbidden`
  - The current identity does not have permission to read the task.
  - Request that read permission be granted to the export task.
```

## Follow-up operations

When there are still files waiting or being processed, continue to query this interface with the same task ID. The export is complete when both the waiting and processing quantities are 0 and there are no failures. When there is a failure, [Query export files](list-export-task-files.md) locates the failed item, and if necessary, [Rerun task](rerun-export-task.md).