---
title: "List all custom object bulk jobs"
method: GET
path: "/objects/jobs"
tags: ["Custom Object Jobs"]
---

# List all custom object bulk jobs

`GET /objects/jobs`

Lists all custom object bulk jobs submitted by your tenant.

## Query parameters

- `pageSize` integer
- `cursor` string
- `status` 'pending' | 'accepted' | 'in_progress' | 'completed' | 'failed' | 'cancelled'

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string, date

## Response `200`

OK

- CustomObjectBulkJobResponseCollection
  - `count` integer — The number of custom object bulk jobs returned in the result page set.
  - `cursor` string — The `cursor` points to the last job record of the current page.
  - `jobs` CustomObjectBulkJobResponse[], required — All custom object bulk jobs returned in the result page set.
    - `CreatedById` string, uuid — The ID of the user who creates the job.
    - `CreatedDate` string, date-time — The time when the bulk job is created.
    - `Id` string, uuid — The custom object bulk job ID.
    - `UpdatedById` string, uuid — The ID of the user who updates the job.
    - `UpdatedDate` string, date-time — The time when the bulk job is updated.
    - `error` object
      - `code` integer — The error code.
      - `message` string — The error message.
    - `namespace` 'default' | 'com_zuora' — The namespace of the object. Custom objects belong to the `default` namespace. Zuora standard objects belong to the `com_zuora` namespace. Bulk job operations on the following Zuora standard objects are supported: * SavedQuery
    - `object` string — The object to that the bulk operation performs on.
    - `operation` 'delete' | 'create' | 'update' — The operation that the bulk job performs. Only the users that have the "Delete Custom Objects" permission can submit a `delete` bulk job request. Only the users that have the "Edit Custom Objects" permission can submit a `create` or `update` bulk job request. See [Platform Permissions](https://docs.zuora.com?resourceId=platform-user-role-for-platform) for more information.
    - `processingTime` integer — The amount of time elapsed, in milliseconds, from the submission to the completion of the bulk job.
    - `recordsProcessed` integer — The number of object records processed by the bulk job.
    - `status` 'accepted' | 'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled' — The status of the bulk job: - `accepted` - The job has been accepted and is ready to process. - `pending` - The job is waiting for your input. You can use [Upload a file for a custom object bulk job](https://developer.zuora.com/api-references/api/operation/POST_UploadFileForCustomObjectBulkJob) to upload a file so that the job can start creating records. - `in_progress` - The job is processing. - `completed` - The job has completed. - `failed` - The job was unable to complete. You can use [List all errors for a custom object bulk job](https://developer.zuora.com/api-references/api/operation/GET_CustomObjectBulkJobErrors) to list the errors. - `cancelled` - The job was cancelled by the server.

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)