---
title: "Verificar estado de Bulk Write"
url: https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/data-store/bulk-write-rows/check-bulk-write-status/
description: "Esta API te permite verificar manualmente el estado de un trabajo de escritura masiva que iniciaste previamente."
last_updated: 2026-03-20T16:21:56Z
service: Cloud Scale
type: api
---

# Verificar estado de Bulk Write

### Descripción

Puedes ejecutar esta API para verificar manualmente el estado del [trabajo de escritura masiva](https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/data-store/bulk-write-rows/create-bulk-write-job/#CreateBulkWriteJob) que iniciaste previamente.

Si no habías configurado una URL de callback en tu solicitud JSON, debes verificar el estado del trabajo tú mismo ejecutando esta API. Debes usar el `job_id` que se te envió en la respuesta automática de estado in-progress cuando iniciaste la operación de escritura masiva, para verificar el estado del trabajo posteriormente.

### Detalles de la solicitud

#### URL de solicitud

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

- **api-domain** (URL): El dominio específico del DC para acceder a Catalyst API

- **project_id** (Numerical): El [ID único](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/general-settings/) del proyecto

- **job_id** (Numerical): <p>El ID único del trabajo que se envió en la [respuesta de estado in-progress](https://docs.catalyst.zoho.com/es/api/introduction/overview-and-prerequisites/#response-details) inicial después de que se ejecutó la API Bulk Write</p>

#### Encabezados de solicitud
 **Authorization:** Zoho-oauthtoken {oauth_token} 

**Encabezados opcionales** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### Scope

ZohoCatalyst.tables.bulk.CREATE

### Detalles de la respuesta

La respuesta JSON para el estado exitoso contendrá los detalles del trabajo ejecutado, junto con una URL de descarga, donde puedes [descargar un archivo de informe CSV](https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/data-store/bulk-write-rows/download-bulk-write-result/#DownloadBulkWriteResult) que contendrá los detalles de la ejecución del trabajo. Listará todos los registros que fueron omitidos de la escritura junto con las razones.

La respuesta JSON para el estado fallido contendrá los detalles del trabajo ejecutado, junto con una descripción del error ocurrido en el procesamiento del trabajo y sus detalles.

**Sample Request**

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

```

**Sample Response: Job in Progress**

```json

    {
        "status": "success",
        "data": {
            "job_id": 2000000110044,
            "status": "In-Progress",
            "operation": "insert",
            "project_details": {
                "project_name": "EmployeeDatabase",
                "id": 4000000006007
            }
            "query": [
                {
                    "table_id": 3376000000165511,
                    "details": {
                        "object_url" : "https://zylker-emp-development.zohostratus.com/employees/emp_rec.csv",
                        
                    }
                }
            ],
            "callback": {
                "url": "https://hr.zylker.com/es/EmpRecords/_callback.php",
                "headers": {
                    "src": "ZCatalyst",
                    "operation": "bulkwriteAPI"
                },
                "params": {
                    "project_name": "EmployeeDatabase"
                }
            },
            "created_by": {
                    "zuid": 3000000006111,
                    "is_confirmed": true,
                    "email_id": "emma@zylker.com",
                    "first_name": "Amelia",
                    "last_name": "Burrows",
                    "user_id": 671930409
            },
            "created_time": "Oct 05, 2020 07:33 PM"
        }
    }
```

**Sample Response: Job Successful**

```json

    {
        "status": "success",
        "data": {
            "job_id": 2000000110044,
            "status": "Completed",
            "operation": "insert",
            "project_details": {
                "project_name": "EmployeeDatabase",
                "id": 4000000006007
            }
            "query": [
                {
                    "table_id": 3376000000165511,
                    "details": {
                        "object_url" : "https://zylker-emp-development.zohostratus.com/employees/emp_rec.csv"
                    }
                }
            ],
            "callback": {
                "url": "https://hr.zylker.com/es/EmpRecords/_callback.php",
                "headers": {
                    "src": "ZCatalyst",
                    "operation": "bulkwriteAPI"
                },
                "params": {
                    "project_name": "EmployeeDatabase"
                }
            },
            "created_by": {
                "zuid": 3000000006111,
                "is_confirmed": true,
                "email_id": "emma@zylker.com",
                "first_name": "Amelia",
                "last_name": "Burrows",
                "user_id": 671930409
            },
            "created_time": "Oct 05, 2020 07:25 PM",
            "results": {
                "download_url": "https://api.catalyst.zoho.com/baas/v1/bulk/write/2000000110013/download",
                "description": "Bulk WRITE job completed. ",
                "details": [
                    {
                        "table_id": 3376000000165511,
                        "records_processed": 176
                    }
                ]
            }
        }
    }
```

**Sample Response: Job Failed**

```json

    {
        "status": "success",
        "data": {
            "job_id": 2000000110044,
            "status": "Failed",
            "operation": "insert",
            "project_details": {
                "project_name": "EmployeeDatabase",
                "id": 4000000006007
            }
            "query": [
                {
                    "table_id": 3376000000165511,
                    "details": {
                        "object_url" : "https://zylker-emp-development.zohostratus.com/employees/emp_rec.csv"
                    }
                }
            ],
            "callback": {
                "url": "https://hr.zylker.com/es/EmpRecords/_callback.php",
                "headers": {
                    "src": "ZCatalyst",
                    "operation": "bulkwriteAPI"
                },
                "params": {
                    "project_name": "EmployeeDatabase"
                }
            },
            "created_by": {
                "zuid": 3000000006111,
                "is_confirmed": true,
                "email_id": "emma@zylker.com",
                "first_name": "Amelia",
                "last_name": "Burrows",
                "user_id": 671930409
            },
            "created_time": "Oct 05, 2020 07:25 PM",
            "results": {
                "description": "The reference_column 'DeptID' in fk_mapping of table 3376000000165511 is not a unique column",
                "details": [ ]
            }
        }
    }
```