---
title: "Check Bulk Read Status"
url: https://docs.catalyst.zoho.com/en/api/code-reference/cloud-scale/data-store/bulk-read-rows/check-bulk-read-status/
description: "This API enables you to manually check the status of a bulk read job that you initiated previously."
last_updated: 2026-08-28T06:26:16Z
service: Cloud Scale
type: api
---

# Check Bulk Read Status

### Description

You can execute this API to manually check the status of the [bulk read job](https://docs.catalyst.zoho.com/en/api/code-reference/cloud-scale/data-store/bulk-read-rows/check-bulk-read-status/#CreateBulkReadJob) that you initiated previously.

If you had not configured a callback URL in your JSON request, you must check the job status yourself by executing this API. You must use the `job_id` that is sent to you in the automatic in-progress response when you initiate the bulk read operation, to check the job status subsequently.

### Request Details

#### Request URL

`GET` {api-domain}/baas/v1/project/{project_id}/bulk/read/{job_id}

- **api-domain** (URL): The DC-specific domain to access Catalyst API

- **project_id** (Numerical): The [unique ID](https://docs.catalyst.zoho.com/en/getting-started/set-up-a-catalyst-project/general-settings/) of the project

- **job_id** (Numerical): <p>The unique ID of the job that was sent in the initial [in-progress status response](https://docs.catalyst.zoho.com/en/api/code-reference/cloud-scale/data-store/bulk-read-rows/create-bulk-read-job/#CreateBulkReadJob) after the Bulk Read API was executed</p>

#### Request Headers
 **Authorization:** Zoho-oauthtoken {oauth_token} 

**Optional Headers** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### Scope

ZohoCatalyst.tables.bulk.READ

### Response Details

The JSON response for the success state will contain the details of the executed job, along with a download URL where you can [download a CSV file](https://docs.catalyst.zoho.com/en/api/code-reference/cloud-scale/data-store/bulk-read-rows/create-bulk-read-job/#DownloadBulkReadResult) that will contain a list of records matching your bulk read job query.

The JSON response for the failed state will contain the details of the executed job, along with a description of the error that occurred in the job processing, and its details, such as the rows that were skipped from being read and the reasons.

**Sample Request**

```bash
curl -X GET \
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/bulk/read/2000000118004  \
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57"

```

**Sample Response: Job in Progress**

```json

    {
    "status": "success",
    "data": {
        "job_id": 2000000118004,
        "status": "In-Progress",
        "operation": "read",
        "project_details": {
            "project_name": "EmployeeDatabase",
            "id": 4000000006007
        },
        "query": [
            {
                "table_id": 3376000000165541,
                "details": {
                    "page": "1"
                }
            }
        ],
        "callback": {
            "url": "https://hr.zylker.com/en/EmpRecords/_callback.php",
            "headers": {
                      "src" : "ZCatalyst",
                      "operation" : "bulkreadAPI"
                              },
            "params": {
                      "project_name" : "EmployeeDatabase"
                             }
        },
        "created_by": {
            "zuid": 1019540152,
            "is_confirmed": true,
            "email_id": "emma@zylker.com",
            "first_name": "Amelia",
            "last_name": "Burrows",
            "user_id": 671930409
        },
        "created_time": "Oct 06, 2020 07:06 PM"
    }
}

```

**Sample Response: Job Successful**

```json

    {
    "status": "success",
    "data": {
        "job_id": 2000000118004,
        "status": "Completed",
        "operation": "read",
        "project_details": {
            "project_name": "EmployeeDatabase",
            "id": 4000000006007
        },
        "query": [
                        {
                "table_id": 3376000000165541,
                "details": {
                    "page": "1"
                                }
                          }
                       ],
        "callback": {
                "url": "https://hr.zylker.com/en/EmpRecords/_callback.php",
                "headers": {
                      "src" : "ZCatalyst",
                      "operation" : "bulkreadAPI"
                              },
                  "params": {
                       "project_name" : "EmployeeDatabase"
                             }
                           },
        "created_by": {
                "zuid": 1019540152,
                "is_confirmed": true,
                "email_id": "emma@zylker.com",
                "first_name": "Amelia",
                "last_name": "Burrows",
                "user_id": 671930409
                               },
        "created_time": "Oct 06, 2020 07:06 PM",
	"results": {
               "download_url": "https://api.catalyst.zoho.com/baas/v1/bulk/read/2000000117007/download",
               "description": "Bulk READ job 2000000117007 completed.",
                "details": [
                                 {
                       "table_id": 3376000000165541,
                       "records_processed": 21,
                       "more_records": false
                                 }
                               ]
                        }
               }
}

```

**Sample Response: Job Failed**

```json

    {
    "status": "success",
    "data": {
        "job_id": 2000000117007,
        "status": "Failed",
        "operation": "read",
        "project_details": {
            "project_name": "EmployeeDatabase",
            "id": 4000000006007
        },
        "query": [
            {
                "table_id": 3376000000165541,
                "details": {
                    "page": "1"
                }
            }
        ],
        "callback": {
            "url": "https://hr.zylker.com/en/EmpRecords/_callback.php",
             "headers": {
                      "src" : "ZCatalyst",
                      "operation" : "bulkreadAPI"
                              },
            "params": {
                       "project_name" : "EmployeeDatabase"
                             }
        },
        "created_by": {
            "zuid": 1019540152,
            "is_confirmed": true,
            "email_id": "emma@zylker.com",
            "first_name": "Amelia",
            "last_name": "Burrows",
            "user_id": 671930409
        },
        "created_time": "Oct 06, 2020 07:00 PM",
        "results": {
            "description": "The column ID in select_columns is invalid",
        }
    }
}

```