Get status of a single bulk operation

GET

https://api.contentful.com/spaces/:space_id/environments/:environment_id/bulk_operations/:bulk_operation_id

GET

/spaces/:space_id/environments/:environment_id/bulk_operations/:bulk_operation_id

$ curl -X GET "https://api.contentful.com/spaces/<space_id>/environments/<environment_id>/bulk_operations/<bulk_operation_id>" \
>   -H "Authorization: Bearer <cma_token>"

1 {
2   "sys": {
3     "id": "4jtu5s4mOmk7FvVlFJRNRl",
4     "type": "BulkContentOperation",
5     "bulkType": "EntriesCreate",
6     "status": "completed",
7     "createdAt": "2025-12-08T14:55:02.713Z",
8     "updatedAt": "2025-12-08T14:55:15.261Z"
9   },
10   "payload": {
11     "upload": {
12       "sys": {
13         "type": "Upload",
14         "id": "6gbwC4qRtakgsdqUcCPihF"
15       }
16     }
17   },
18   "result": {
19     "items": [
20       {
21         "status": "succeeded",
22         "entity": {
23           "sys": {
24             "type": "Entry",
25             "id": "entry-1"
26           }
27         }
28       },
29       {
30         "status": "failed",
31         "error": {
32           "sys": {
33             "type": "Error",
34             "id": "InvalidEntry"
35           },
36           "message": "Validation error"
37         }
38       }
39     ]
40   }
41 }

Returns the status of a bulk operation by ID. Check sys.status for state and result.items for per-entry outcomes; export jobs return result.files with signed ZIP URLs.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

space_idstringRequired

Alphanumeric id of the space.

environment_idstringRequired

Alphanumeric id of the environment. Defaults to master.

bulk_operation_idstringRequired

Alphanumeric id of the bulk operation.

Response

OK - Request successful

Errors

403

Forbidden Error

404

Not Found Error

500

Internal Server Error