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

# List Book copy jobs

`GET /v1/book/copy-jobs`

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.net/ocrolus/apis/user-management.md) · [All operations](https://skmtc.net/ocrolus/apis/user-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ocrolus/user-management/revisions/3571ef602d13/schema)