---
title: "Retrieve an async task"
method: GET
path: "/async_tasks/{async_task}"
tags: ["Async Tasks"]
---

# Retrieve an async task

`GET /async_tasks/{async_task}`

Endpoint to fetch an AsyncTask.

Async Tasks are created when a long-running process is initiated (e.g. form generation) and can be used to track the progress of that process and fetch the results once it is completed.

The following example is for a Form Generation task, but the response fields will differ depending on the specific AsyncTask instance requested.

## Path parameters

- `async_task` string, required

## Response `200`

OK

- object
  - `id` string — The unique identifier of the object in Nmbr.
  - `object` string — The type of the object in Nmbr (`"async_task"`).
  - `data` AsyncTask
    - `type` 'batch_delete' | 'batch_upsert' | 'bulk_create' | 'bulk_delete' | 'bulk_update' | 'form_generation' | 'scenario_seed'
    - `status` 'completed' | 'error' | 'processing'
    - `completed_at` string, dateTime, nullable
    - `results` object, nullable
    - `created_at` string, dateTime — The date and time the object was created in Nmbr.
    - `updated_at` string, dateTime — The date and time the object was last updated in Nmbr.

---

[API](https://skmtc.dev/nmbr/apis/nmbr-api.md) · [All operations](https://skmtc.dev/nmbr/apis/nmbr-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nmbr/nmbr-api/revisions/22e92d8c3376/schema)