---
title: "Upload Pay stub PDF to Book"
method: POST
path: "/v2/book/{book_uuid}/document/paystub"
tags: ["File Uploads"]
---

# Upload Pay stub PDF to Book

`POST /v2/book/{book_uuid}/document/paystub`

Upload a known <<glossary:Pay stub>> file directly to a specific <<glossary:Book>>.

---
You can upload a file to this endpoint as a `multipart/form-data` encoded payload. Visit [our guide](https://docs.ocrolus.com/reference/multipartform-data-payloads) for more information.

If successful, the response will return the specific doc_uuid for the uploaded <<glossary:Document>>.
> 📘
>  - This endpoint is limited to PDF's where the form type is expected to be a PAYSTUB.
>  - The maximum file size allowed for upload is 200 MB.

## Path parameters

- `book_uuid` string, required

## Response `200`

Success

- union
  - object
    - `status` integer — A numerical code that indicates the status of the request.
    - `message` string — A textual description that indicates details about this response's status.
    - `response` object — An object received from the server that potentially contains data.
      - `doc_uuid` string — Universally unique identifier (uuid) of the uploaded Document.
  - object
    - `status` integer — A numerical code that indicates the status of the request.
    - `response` object — An object received from the server that potentially contains data.
      - `status` integer — A numerical code that indicates the status of the request.
      - `message` string — A text based description that indicates details about this response's status.
    - `message` string — A textual description that indicates details about this response's status.
  - object
    - `status` integer — A numerical code that indicates the status of the request.
    - `response` object — An object received from the server that potentially contains data.
      - `status` integer — A numerical code that indicates the status of the request.
      - `message` string — A textual description that indicates details about this response's status.
      - `original_existing_doc_uuid` string — Unique identifers (UUID) of the previously uploaded Document in this book.
    - `message` string — A textual description that indicates details about this response's status.

## Other responses

- `400` — Client Errors

---

[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/versions/3571ef602d13/schema)