---
title: "Get async operations list for current user by status"
method: GET
path: "/async_tasks/by_status/{status}"
tags: ["Async Tasks"]
---

# Get async operations list for current user by status

`GET /async_tasks/by_status/{status}`

## Request

- Base URL: `https://dataops.nexla.io/nexla-api`
- URL: `https://dataops.nexla.io/nexla-api/async_tasks/by_status/{status}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nexla/apis/nexla-rest-api/docs/async_tasks/by_status/:status/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a list of async operations for current user of a specific type. Returns type, arguments, status, results etc.

## Path parameters

- `status` 'pending' | 'running' | 'completed' | 'failed' | 'cancelled', required: The status of the task.

## Headers

- `Accept` 'application/vnd.nexla.api.v1+json' | 'application/json': Setting to `application/vnd.nexla.api.v1+json` is recommended.

## Response `200`

Success

- AsyncTask[]
  - `id` string: The unique identifier of the task.
  - `type` 'BulkDeleteNotifications' | 'BulkMarkAsReadNotifications' | 'BulkPauseFlows' | 'CallProbe' | 'ChownUserResources' | 'DeactivateUser' | 'GetAuditLogs'
  - `status` 'pending' | 'running' | 'completed' | 'failed' | 'cancelled': The status of the task.
  - `progress` integer: The progress of the task.
  - `priority` integer: The priority of the task.
  - `created_at` string, date-time: The date and time the task was created.
  - `stopped_at` string, date-time: The date and time the task was completed, failed or stopped in another way.
  - `result` object: The result of the task.
  - `result_url` string: The URL to the result of the task.
  - `error` object: The error that occurred during the task.
  - `owner` Owner
    - `id` integer
    - `full_name` string
    - `email` string, email
  - `org` Org
    - `id` integer
    - `name` string
    - `email_domain` string
    - `email` unknown
    - `client_identifier` unknown

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/nexla/apis/nexla-rest-api.md) - [All operations](https://skmtc.dev/nexla/apis/nexla-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nexla/apis/nexla-rest-api/revisions/ef02be92fe7b?raw)