---
title: "List Async Actions"
method: GET
path: "/v1/async-actions"
tags: ["Async Actions"]
---

# List Async Actions

`GET /v1/async-actions`

Track asynchronous operations scheduled in your project.  

The table below lists the possible types of async actions. The types are different for each endpoint generating the async action.

| **Types by Context** | **Endpoint** |
|:---|:---|
| **CAMPAIGN** |  |
| CAMPAIGN.VOUCHERS_IMPORT | **POST**   [`/campaigns/{campaignId}/import`](/api-reference/campaigns/import-vouchers-to-campaign) |
| CAMPAIGN.VOUCHERS_IMPORT_CSV | **POST**   [`/campaigns/{campaignId}/importCSV`](/api-reference/campaigns/import-vouchers-to-campaign-by-csv) |
| CAMPAIGN.VOUCHERS_UPDATE | **PUT** [`/campaigns/{campaignId}`](/api-reference/campaigns/update-campaign) |
| CAMPAIGN.VOUCHERS_DELETE | **DELETE** [`/campaigns/{campaignId}`](/api-reference/campaigns/delete-campaign) |
| CAMPAIGN.VOUCHERS_GENERATE | <ul><li>**POST** [`/campaigns`](/api-reference/campaigns/create-campaign): asynchronous for campaigns with more than 1 voucher, synchronous for campaign with 1 voucher</li><li>**POST**    [`/campaigns/{campaignId}/vouchers`](/api-reference/campaigns/add-vouchers-to-campaign)</li></ul> |
| **CUSTOMERS** |  |
| CUSTOMERS.IMPORT_CSV | **POST** [`/customers/importCSV`](/api-reference/customers/import-and-update-customers-using-csv) |
| CUSTOMERS.BULK_UPDATE | **POST** [`/customers/bulk/async`](/api-reference/customers/update-customers-in-bulk) |
| CUSTOMERS.METADATA_UPDATE | **POST** [`/customers/metadata/async`](/api-reference/customers/update-customers-metadata-in-bulk) |
| **PRODUCTS** |  |
| PRODUCTS.BULK_UPDATE | **POST** [`/products/bulk/async`](/api-reference/products/update-products-in-bulk)<br /> |
| PRODUCTS.METADATA_UPDATE | **POST** [`/products/metadata/async`](/api-reference/products/update-products-metadata-in-bulk) |
| PRODUCTS.IMPORT_CSV | **POST** [`/products/importCSV`](/api-reference/products/import-products-using-csv) |
| SKUS.IMPORT_CSV | **POST** [`/skus/importCSV`](/api-reference/products/import-skus-using-csv) |
| **VOUCHERS** |  |
| VOUCHERS.IMPORT | **POST** [`/vouchers/import`](/api-reference/vouchers/import-vouchers) |
| VOUCHERS.IMPORT_CSV | **POST** [`/vouchers/importCSV`](/api-reference/vouchers/import-vouchers-using-csv) |
| VOUCHERS.BULK_UPDATE | **POST** [`/vouchers/bulk/async`](/api-reference/vouchers/update-vouchers-in-bulk)<br /> |
| VOUCHERS.METADATA_UPDATE | **POST** [`/vouchers/metadata/async`](/api-reference/vouchers/update-vouchers-metadata-in-bulk) | 
| **ORDERS** |  |
| ORDERS.IMPORT | **POST** [`/orders/import`](/api-reference/orders/import-orders) |
| **METADATA KEY PURGE** |  |
| CAMPAIGNS.METADATA_KEY_PURGE<br />CUSTOMERS.METADATA_KEY_PURGE<br />PRODUCTS.METADATA_KEY_PURGE<br />VOUCHERS.METADATA_KEY_PURGE<br />ORDERS.METADATA_KEY_PURGE | No API endpoint equivalent. You can perform this action through the Dashboard. See Dashboard documentation: Dashboard > [Project Settings](/prepare/metadata#maintenance) |

## Query parameters

- `limit` integer
- `end_date` string, date-time

## Response `200`

Returns a list of all scheduled asynchronous actions and detailed information for each scheduled action. Note that a status `DONE`doesn't include the result of the completed action. If you need more information about the result, use the ID of the respective async action to call the [Get Async Action](/api-reference/async-actions/get-async-action) endpoint.

- AsyncActionsListResponseBody — Response body schema for **GET** `v1/async-actions`.
  - `object` 'list' — The type of the object represented by JSON. This object stores information about asynchronous actions.
  - `data_ref` 'async_actions' — Identifies the name of the JSON property that contains the array of asynchronous actions.
  - `async_actions` AsyncActionBase[]
    - `id` string — Async action unique ID.
    - `type` 'CAMPAIGN.VOUCHERS_IMPORT' | 'CAMPAIGN.VOUCHERS_IMPORT_CSV' | 'CAMPAIGN.VOUCHERS_UPDATE' | 'CAMPAIGN.VOUCHERS_DELETE' | 'CAMPAIGN.VOUCHERS_GENERATE' | 'CAMPAIGNS.METADATA_KEY_PURGE' | 'CUSTOMERS.IMPORT_CSV' | 'CUSTOMERS.BULK_UPDATE' | 'CUSTOMERS.METADATA_UPDATE' | 'CUSTOMERS.METADATA_KEY_PURGE' | 'PRODUCTS.BULK_UPDATE' | 'PRODUCTS.METADATA_UPDATE' | 'PRODUCTS.METADATA_KEY_PURGE' | 'PRODUCTS.IMPORT_CSV' | 'SKUS.IMPORT_CSV' | 'VOUCHERS.IMPORT' | 'VOUCHERS.IMPORT_CSV' | 'VOUCHERS.BULK_UPDATE' | 'VOUCHERS.METADATA_UPDATE' | 'VOUCHERS.METADATA_KEY_PURGE' | 'ORDERS.IMPORT' | 'ORDERS.METADATA_KEY_PURGE' — Type of async action.
    - `status` 'DONE' | 'ENQUEUED' | 'FAILED' | 'IN_PROGRESS' — Status of the async action. Informs you whether the async action has already been completed.
    - `operation_status` 'FAILED' | 'SUCCESS' | 'UNKNOWN' — Status of async action processing. Informs about the async action status, whether it failed, succeeded, or the status is unknown.
    - `created_at` string, date-time — Timestamp representing the date and time when the async action was scheduled in ISO 8601 format.
    - `updated_at` string, date-time — Timestamp representing the date and time when the async action was updated. The value is shown in the ISO 8601 format.
    - `request_id` string — Unique request ID.
    - `processing_time` integer — The length of time it took to process the request in milliseconds.
    - `progress` integer — % progress to completion of the asynchronous action.
    - `object` 'async_action' — The type of the object represented by JSON. This object stores information about the `async_action`.
  - `has_more` boolean — As query results are always limited by parameters, the `has_more` flag indicates if there are more records available. This lets you know if you can run another request to get more records returned in the results.

## Other responses

- `400` — Returns an error if incorrect query parameters were provided.

---

[API](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions.md) · [All operations](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voucherifyio/voucherify-api-async-actions/revisions/4982266e0494/schema)