> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# GetAsyncJobStatus

# Package: cms

# Namespace: DataItemService

# Method link: https://dev.wix.com/docs/api-reference/business-solutions/cms/data-items/get-async-job-status.md

## Permission Scopes:
Read Data Items: SCOPE.DC-DATA.READ

## Introduction

Retrieves the status of an async job started by [Async Patch Data Items By Filter](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/async-patch-data-items-by-filter.md)
or [Async Remove Data Items By Filter](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/async-remove-data-items-by-filter.md).

Poll this endpoint until the status reaches a terminal state: `SUCCEEDED` or `FAILED`.
Job records are retained for 30 days after reaching a terminal state.
Querying an expired or unknown `jobId` returns `NOT_FOUND`.

When status is `FAILED`, use `successCount` to understand how far the job progressed,
then re-run the originating async operation with a modified filter that excludes already-processed items.

---

## REST API

### Schema

```
 Method: getAsyncJobStatus
 Description: Retrieves the status of an async job started by [Async Patch Data Items By Filter](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/async-patch-data-items-by-filter.md) or [Async Remove Data Items By Filter](https://dev.wix.com/docs/rest/business-solutions/cms/data-items/async-remove-data-items-by-filter.md).  Poll this endpoint until the status reaches a terminal state: `SUCCEEDED` or `FAILED`. Job records are retained for 30 days after reaching a terminal state. Querying an expired or unknown `jobId` returns `NOT_FOUND`.  When status is `FAILED`, use `successCount` to understand how far the job progressed, then re-run the originating async operation with a modified filter that excludes already-processed items.
 URL: https://www.wixapis.com/wix-data/v2/async-jobs/{jobId}/status
 Method: GET
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  jobId
 Method parameters: 
   param name: jobId | type:   none | required: true 
 Return type: GetAsyncJobStatusResponse
  - name: status | type: Status | description: Current status of the async operation.  
     - enum:
     -     INITIALIZED: Job has been created but processing has not started yet.
     -     PROCESSING: Job is actively processing items.
     -     SUCCEEDED: Job has completed successfully.
     -     FAILED: Job stopped due to an error. Some items may already have been processed. To recover, re-run the originating async operation with a modified filter that excludes already-processed items. Use `successCount` to estimate how many items were processed before the failure.
  - name: successCount | type: integer | description: Number of items successfully processed. At terminal status (`SUCCEEDED` or `FAILED`), this is the final count.  


```

### Examples

### Get async job status
```curl
curl -X GET \
'https://www.wixapis.com/wix-data/v2/async-jobs/5b4d5e5c-6ef7-4cf9-9f74-5b9fd7b6be9e/status' \
-H 'Authorization: <AUTH>' \
```

---