---
title: "List Book copy jobs"
method: GET
path: "/v1/book/copy-jobs"
tags: ["Encore"]
---

# List Book copy jobs

`GET /v1/book/copy-jobs`

## Request

- Base URL: `https://api.ocrolus.com`
- URL: `https://api.ocrolus.com/v1/book/copy-jobs`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.ocrolus.com/oauth/token`

This API retrieves a list of <<glossary:Book>> copy jobs and their details. By default, it returns outbound jobs—requests your organization sent. You can also fetch inbound jobs—requests sent to your organization.

> 📘 Note
> This API is intended for small and medium business (SMB) funders.

## Query parameters

- `job_type` 'OUTBOUND' | 'INBOUND'
- `org_uuid` string, uuid
- `offset` integer
- `limit` integer

## Response `200`

Success

- object
  - `copy_jobs` object[]: A list of copy job objects.
    - `job_id` string: The unique identifier (UUID) for the copy job.
    - `book_uuid` string: The UUID of the Book.
    - `org_uuid` string: The UUID of the sendor or recipient organization based on the specified job types. For `INBOUND` jobs, this will be the sender's organization UUID and for `OUTBOUND` jobs, this will be the recipient's organization UUID.
    - `status` string: The status of the copy job. Possible values: - **`PENDING`**: Job created, awaiting processing. - **`AWAITING_RECIPIENT`**: Waiting for recipient acceptance. - **`IN_PROGRESS`**: Currently processing. - **`SUCCESSFUL`**: Completed successfully. - **`REJECTED`**: Rejected by recipient. - **`FAILED`**: Failed with error.
    - `created_ts` string, date-time: The timestamp when the copy job was created.
    - `shared_book_label` string: An optional unique identifier assigned for each individual Book share request.
  - `total` integer: Total number of copy jobs.
  - `offset` integer: The starting index of the result.
  - `limit` integer: The maximum number of transactions returned per page starting from the specified **`offset`** value.

## Other responses

- `400`: Client Errors
- `401`: Unauthorized
- `500`: Internal server error

---

[API](https://skmtc.dev/ocrolus/apis/encore.md) - [All operations](https://skmtc.dev/ocrolus/apis/encore/llms.txt) - [OpenAPI document](https://skmtc.dev/ocrolus/apis/encore/revisions/09ef8c1b8910?raw)