---
updatedAt: 2026-09-01T07:52:50.000Z
agentTools:
  projectIndex: https://docs.ocrolus.com/llms.txt
---

# Book status

This API retrieves the status of a <<glossary:Book>>.
--- Use this endpoint to retrieve details about a Book, including its current processing status and the status of each Document within it. Book status reflects the overall state of the Book across its processing life cycle,  while Document status reflects the individual processing stage of each Document uploaded to the Book. For more information, see [Book Statuses](doc:book-status-code) and [Document Statuses](doc:document-status).

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Book Queries",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.ocrolus.com"
    }
  ],
  "security": [
    {
      "oauth": []
    }
  ],
  "paths": {
    "/v1/books": {
      "get": {
        "summary": "Book list",
        "description": "This API retrieves a list of all <<glossary:Book>>s available to the current user. It returns the following two different response shapes depending on whether the `limit` parameter is supplied, select the schema and example that matches your use case:\n  - **Unpaginated**: When `limit` is omitted, the response is a bare array of Book objects with no wrapper.\n  - **Paginated**: When `limit` is supplied, the response is an object containing `_links`, `limit`, `total_book_count`, and `books`.\n\n  ---\n\n  > 📘 Note\n    > - By default results are ordered by <<glossary:Book>> PK in descending order but you can alter how and what books are returned by providing different parameters with your request.\n    > - Use the `name` query parameter to find a <<glossary:Book>> by an exact name. This will be faster than `search` which uses approximate string matching algorithm.\n",
        "operationId": "book-list",
        "tags": [
          "Book Queries"
        ],
        "parameters": [
          {
            "name": "book_class",
            "in": "query",
            "description": "Filter books by book class. If `COMPLETE` is among the values, books with no class set are also included.",
            "example": "INSTANT",
            "schema": {
              "type": "string",
              "enum": [
                "COMPLETE",
                "INSTANT",
                "INSTANT_CLASSIFY_ONLY",
                "INSTANT_CLASSIFY_ISO_CAPTURE"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of Books to return per page. When omitted, the endpoint returns all matching Books as a bare JSON array with no pagination wrapper. When supplied, the response changes to a paginated object containing `_links`, `limit`, `total_book_count`, and `books`.",
            "example": 10,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "Number of Books to skip before returning results. Use with limit to paginate through large collections. The list is index-based and starts at integer 0. An offset of 10 skips the first 10 results.",
            "example": 10,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "order",
            "in": "query",
            "description": "Sort direction for the results. `DESC` returns the newest Books first (default) whereas `ASC` returns the oldest first. By default, results are returned in descending order.",
            "example": "ASC",
            "schema": {
              "type": "string",
              "enum": [
                "ASC",
                "DESC"
              ]
            }
          },
          {
            "name": "order_by",
            "in": "query",
            "description": "Field to sort the results by. Use `created` to sort by creation date, `name` to sort alphabetically, or `pk` to sort by Book ID.",
            "example": "created",
            "schema": {
              "type": "string",
              "enum": [
                "created",
                "name",
                "pk"
              ]
            }
          },
          {
            "name": "name",
            "in": "query",
            "description": "Returns only the Book whose name matches this value exactly.",
            "example": "My_Book",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "Return Books whose names approximately match the search term.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "xid",
            "in": "query",
            "description": "Return only the Book whose external ID (xid) matches this value exactly.",
            "schema": {
              "type": "string",
              "example": "sample-xid"
            }
          }
        ],
        "x-readme": {
          "samples-languages": [
            "curl",
            "python"
          ],
          "explorer-enabled": false
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "title": "Unpaginated object (limit omitted)",
                      "properties": {
                        "status": {
                          "type": "number",
                          "description": "A numerical code that indicates the status of the request.",
                          "example": 200
                        },
                        "response": {
                          "type": "array",
                          "description": "An array containing objects of <<glossary:Book>>s. Returned when `limit` is not supplied.",
                          "items": {
                            "type": "object",
                            "properties": {
                              "pk": {
                                "type": "integer",
                                "description": "Primary key of the <<glossary:Book>>.",
                                "example": 26087155
                              },
                              "id": {
                                "type": "integer",
                                "description": "ID of the <<glossary:Book>> (same as `pk`).",
                                "example": 26087155
                              },
                              "name": {
                                "type": "string",
                                "description": "Name of the <<glossary:Book>>.",
                                "example": "Example Book 1"
                              },
                              "created": {
                                "type": "string",
                                "description": "ISO timestamp when the <<glossary:Book>> was created.",
                                "example": "2022-11-28T18:24:02Z"
                              },
                              "created_ts": {
                                "type": "string",
                                "description": "ISO timestamp when the <<glossary:Book>> was created.",
                                "example": "2022-11-28T18:24:02Z"
                              },
                              "owner_email": {
                                "type": "string",
                                "description": "Email of the <<glossary:Book>> owner.",
                                "example": "email@address.com"
                              },
                              "is_public": {
                                "type": "boolean",
                                "description": "Whether the <<glossary:Book>> is public.",
                                "example": true
                              },
                              "book_uuid": {
                                "type": "string",
                                "description": "UUID of the <<glossary:Book>>.",
                                "example": "b6e6b2f5-7d14-4580-9beb-5ec9b0d56e32"
                              },
                              "book_type": {
                                "type": "string",
                                "description": "Type of the Book. Possible values: DEFAULT, INSTANT_ML, WIDGET.",
                                "enum": [
                                  "DEFAULT",
                                  "INSTANT_ML",
                                  "WIDGET"
                                ],
                                "example": "DEFAULT"
                              },
                              "xid": {
                                "type": "string",
                                "nullable": true,
                                "description": "External ID of the <<glossary:Book>>.",
                                "example": null
                              }
                            }
                          }
                        },
                        "message": {
                          "type": "string",
                          "description": "A textual description that indicates details about this response's status.",
                          "example": "OK"
                        }
                      }
                    },
                    {
                      "title": "Paginated object (limit supplied)",
                      "properties": {
                        "status": {
                          "type": "number",
                          "description": "A numerical code that indicates the status of the request.",
                          "example": 200
                        },
                        "response": {
                          "type": "object",
                          "description": "Paginated response object returned when `limit` is supplied.",
                          "properties": {
                            "_links": {
                              "type": "object",
                              "description": "Pagination links. `self` (always present), `next` (if more results exist), `prev` (if offset > 0).",
                              "properties": {
                                "self": {
                                  "type": "string",
                                  "description": "URL of the current page of results.",
                                  "example": "/books?limit=2&offset=0"
                                },
                                "next": {
                                  "type": "string",
                                  "description": "URL of the next page of results. Present only when more results exist beyond the current page.",
                                  "example": "/books?limit=2&offset=2"
                                },
                                "prev": {
                                  "type": "string",
                                  "description": "URL of the previous page of results. Present only when offset is greater than 0.",
                                  "example": "/books?limit=2&offset=0"
                                }
                              }
                            },
                            "limit": {
                              "type": "integer",
                              "description": "Number of Books per page.",
                              "example": 2
                            },
                            "total_book_count": {
                              "type": "integer",
                              "description": "Total number of matching Books.",
                              "example": 47
                            },
                            "books": {
                              "type": "array",
                              "description": "List of Books for the current page.",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "pk": {
                                    "type": "integer",
                                    "description": "Primary key of the <<glossary:Book>>.",
                                    "example": 26087155
                                  },
                                  "id": {
                                    "type": "integer",
                                    "description": "ID of the <<glossary:Book>> (same as `pk`).",
                                    "example": 26087155
                                  },
                                  "name": {
                                    "type": "string",
                                    "description": "Name of the <<glossary:Book>>.",
                                    "example": "Example Book 1"
                                  },
                                  "created": {
                                    "type": "string",
                                    "description": "ISO timestamp when the <<glossary:Book>> was created.",
                                    "example": "2022-11-28T18:24:02Z"
                                  },
                                  "created_ts": {
                                    "type": "string",
                                    "description": "ISO timestamp when the <<glossary:Book>> was created.",
                                    "example": "2022-11-28T18:24:02Z"
                                  },
                                  "owner_email": {
                                    "type": "string",
                                    "description": "Email of the <<glossary:Book>> owner.",
                                    "example": "email@address.com"
                                  },
                                  "is_public": {
                                    "type": "boolean",
                                    "description": "Whether the <<glossary:Book>> is public.",
                                    "example": true
                                  },
                                  "book_uuid": {
                                    "type": "string",
                                    "description": "UUID of the <<glossary:Book>>.",
                                    "example": "b6e6b2f5-7d14-4580-9beb-5ec9b0d56e32"
                                  },
                                  "book_type": {
                                    "type": "string",
                                    "description": "Type of the Book. Possible values: DEFAULT, INSTANT_ML, WIDGET.",
                                    "enum": [
                                      "DEFAULT",
                                      "INSTANT_ML",
                                      "WIDGET"
                                    ],
                                    "example": "DEFAULT"
                                  },
                                  "xid": {
                                    "type": "string",
                                    "nullable": true,
                                    "description": "External ID of the <<glossary:Book>>.",
                                    "example": null
                                  }
                                }
                              }
                            }
                          }
                        },
                        "message": {
                          "type": "string",
                          "description": "A textual description that indicates details about this response's status.",
                          "example": "OK"
                        }
                      }
                    }
                  ]
                },
                "examples": {
                  "Unpaginated": {
                    "value": {
                      "status": 200,
                      "response": [
                        {
                          "name": "Example Book 1",
                          "created": "2022-11-28T18:24:02Z",
                          "created_ts": "2022-11-28T18:24:02Z",
                          "pk": 26087155,
                          "owner_email": "email@address.com",
                          "is_public": true,
                          "book_uuid": "b6e6b2f5-7d14-4580-9beb-5ec9b0d56e32",
                          "id": 26087155,
                          "xid": null,
                          "book_type": "DEFAULT"
                        },
                        {
                          "name": "Example Book 2",
                          "created": "2022-11-10T19:00:45Z",
                          "created_ts": "2022-11-10T19:00:45Z",
                          "pk": 25304702,
                          "owner_email": "email@address.com",
                          "is_public": true,
                          "book_uuid": "9b465c7f-45fd-4112-ae7c-972039e778e2",
                          "id": 25304702,
                          "xid": null,
                          "book_type": "DEFAULT"
                        }
                      ],
                      "message": "OK"
                    }
                  },
                  "Paginated": {
                    "value": {
                      "status": 200,
                      "response": {
                        "_links": {
                          "self": "/books?limit=2&offset=0",
                          "next": "/books?limit=2&offset=2"
                        },
                        "limit": 2,
                        "total_book_count": 47,
                        "books": [
                          {
                            "name": "Example Book 1",
                            "created": "2022-11-28T18:24:02Z",
                            "created_ts": "2022-11-28T18:24:02Z",
                            "pk": 26087155,
                            "owner_email": "email@address.com",
                            "is_public": true,
                            "book_uuid": "b6e6b2f5-7d14-4580-9beb-5ec9b0d56e32",
                            "id": 26087155,
                            "xid": null,
                            "book_type": "DEFAULT"
                          }
                        ]
                      },
                      "message": "OK"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Client Errors",
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "status": {
                      "type": "integer",
                      "description": "A numerical code that indicates the status of the request.",
                      "example": 400
                    },
                    "code": {
                      "type": "integer",
                      "description": "A numerical code that indicates the nature of an error.",
                      "example": 1401
                    },
                    "response": {
                      "type": "object",
                      "description": "An object received from the server that potentially contains data."
                    },
                    "message": {
                      "type": "string",
                      "description": "A textual description that indicates details about this response's status.",
                      "example": "Book not found"
                    },
                    "meta": {
                      "type": "object",
                      "description": "An object received from the server that potentially contains data.",
                      "properties": {
                        "status": {
                          "type": "integer",
                          "example": 400,
                          "description": "A numerical code that indicates the status of the request."
                        },
                        "message": {
                          "type": "string",
                          "example": "Book not found",
                          "description": "A textual description that indicates details about this response's status."
                        },
                        "code": {
                          "type": "integer",
                          "example": 1401,
                          "description": "A numerical code that indicates the nature of an error."
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "Book not found": {
                    "value": {
                      "status": 400,
                      "code": 1401,
                      "response": null,
                      "message": "Book not found",
                      "meta": {
                        "status": 400,
                        "msg": "Book not found",
                        "code": 1401
                      }
                    }
                  },
                  "Missing Required Parameters": {
                    "value": {
                      "status": 400,
                      "code": 1103,
                      "response": null,
                      "message": "Required pk or book uuid",
                      "meta": {
                        "status": 400,
                        "msg": "Required pk or book uuid",
                        "code": 1103
                      }
                    }
                  },
                  "No Permission": {
                    "value": {
                      "status": 400,
                      "code": 2102,
                      "response": null,
                      "message": "No permission to access this book",
                      "meta": {
                        "status": 400,
                        "msg": "No permission to access this book",
                        "code": 2102
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "status": {
                      "type": "integer",
                      "description": "A numerical code that indicates the status of the request."
                    },
                    "message": {
                      "type": "string",
                      "description": "A textual description that indicates details about this response's status."
                    }
                  }
                },
                "examples": {
                  "Internal Server Error": {
                    "value": {
                      "status": 500,
                      "message": "Internal Server Error."
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/book/status": {
      "get": {
        "summary": "Book status",
        "operationId": "book-status",
        "description": "This API retrieves the status of a <<glossary:Book>>.\n--- Use this endpoint to retrieve details about a Book, including its current processing status and the status of each Document within it. Book status reflects the overall state of the Book across its processing life cycle,  while Document status reflects the individual processing stage of each Document uploaded to the Book. For more information, see [Book Statuses](doc:book-status-code) and [Document Statuses](doc:document-status).",
        "tags": [
          "Book Queries"
        ],
        "parameters": [
          {
            "name": "book_uuid",
            "in": "query",
            "description": "The unique identifier of the <<glossary:Book>> whose status you want to retrieve. Mutually exclusive with `book_pk`.",
            "example": "19aab921-25a5-4beb-a59e-ac72320061d6",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "pk",
            "in": "query",
            "description": "Unique primary key (pk) of the <<glossary:Book>> whose status you want to retrieve. Mutually exclusive with `book_uuid`.",
            "example": 30219565,
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-readme": {
          "samples-languages": [
            "curl",
            "python"
          ],
          "explorer-enabled": false
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "status": {
                      "type": "integer",
                      "example": 200,
                      "description": "A numerical code that indicates the status of the request."
                    },
                    "response": {
                      "type": "object",
                      "description": "An object received from the server that potentially contains data.",
                      "properties": {
                        "pk": {
                          "type": "integer",
                          "description": "Primary key of the <<glossary:Book>>.",
                          "example": 34251191
                        },
                        "id": {
                          "type": "integer",
                          "description": "ID of the <<glossary:Book>> (same as `pk`).",
                          "example": 34251191
                        },
                        "uuid": {
                          "type": "string",
                          "description": "UUID of the <<glossary:Book>>.",
                          "example": "9ef345ab-33fe-4f0d-ad63-27c47f6419b3"
                        },
                        "name": {
                          "type": "string",
                          "description": "Name of the <<glossary:Book>>.",
                          "example": "Example Book"
                        },
                        "owner_email": {
                          "type": "string",
                          "description": "Email of the <<glossary:Book>> owner.",
                          "example": "email@address.com"
                        },
                        "is_public": {
                          "type": "boolean",
                          "description": "Whether the <<glossary:Book>> is public.",
                          "example": true
                        },
                        "is_shared_or_public_book": {
                          "type": "boolean",
                          "description": "Whether the <<glossary:Book>> is shared or public.",
                          "example": true
                        },
                        "created": {
                          "type": "string",
                          "description": "ISO timestamp when the <<glossary:Book>> was created.",
                          "example": "2023-05-30T16:15:14Z"
                        },
                        "created_ts": {
                          "type": "string",
                          "description": "ISO timestamp when the <<glossary:Book>> was created.",
                          "example": "2023-05-30T16:15:13Z"
                        },
                        "book_class": {
                          "type": "string",
                          "description": "The processing type of the Book.",
                          "enum": [
                            "COMPLETE",
                            "INSTANT",
                            "INSTANT_CLASSIFY_ONLY",
                            "INSTANT_CLASSIFY_ISO_CAPTURE"
                          ],
                          "example": "COMPLETE"
                        },
                        "book_status": {
                          "type": "string",
                          "description": "Status of the <<glossary:Book>>.",
                          "enum": [
                            "CREATED",
                            "UPLOAD",
                            "VERIFYING",
                            "VERIFIED"
                          ],
                          "example": "VERIFIED"
                        },
                        "docs": {
                          "type": "array",
                          "description": "An array of all the <<glossary:Document>>s uploaded to the <<glossary:Book>>.",
                          "items": {
                            "type": "object",
                            "properties": {
                              "pk": {
                                "type": "integer",
                                "description": "Primary key of the <<glossary:Document>>.",
                                "example": 55877634
                              },
                              "id": {
                                "type": "integer",
                                "description": "ID of the <<glossary:Document>> (same as `pk`).",
                                "example": 55877634
                              },
                              "uuid": {
                                "type": "string",
                                "description": "UUID of the <<glossary:Document>>.",
                                "example": "de548ffc-5df5-4bb4-b14a-42eb27c34364"
                              },
                              "name": {
                                "type": "string",
                                "description": "Name of the <<glossary:Document>>.",
                                "example": "paystubexample.pdf(0)"
                              },
                              "pages": {
                                "type": "integer",
                                "description": "Number of pages in the <<glossary:Document>>.",
                                "example": 1
                              },
                              "md5": {
                                "type": "string",
                                "description": "MD5 checksum of the <<glossary:Document>>.",
                                "example": "88e004f15a4ca3dc057a0baf8dcd8774"
                              },
                              "status": {
                                "type": "string",
                                "description": "Processing status of the <<glossary:Document>>.",
                                "example": "VERIFICATION_COMPLETE"
                              },
                              "document_class": {
                                "type": "string",
                                "description": "Document class indicating the processing type of the document.",
                                "enum": [
                                  "COMPLETE",
                                  "INSTANT"
                                ],
                                "example": "COMPLETE"
                              },
                              "image_group_pk": {
                                "type": "integer",
                                "nullable": true,
                                "description": "Primary key of the image group associated with the <<glossary:Document>>.",
                                "example": null
                              },
                              "mixed_uploaded_doc_pk": {
                                "type": "integer",
                                "nullable": true,
                                "description": "Primary key of the Mixed Document this <<glossary:Document>> was extracted from.",
                                "example": 11565050
                              },
                              "rejection_reason": {
                                "type": "string",
                                "description": "Rejection reason if the <<glossary:Document>> was rejected. Present only when `status` is `REJECTED`. This field is omitted entirely from the object when the document has not been rejected.",
                                "example": "INVALID DOCUMENT"
                              },
                              "rejection_reason_description": {
                                "type": "string",
                                "description": "Detailed description of the rejection reason. Present only when `status` is `REJECTED`. Omitted entirely from the object when the document has not been rejected.",
                                "example": "The document could not be processed."
                              }
                            }
                          }
                        },
                        "mixed_docs": {
                          "type": "array",
                          "description": "An array of all the Mixed Documents uploaded to the <<glossary:Book>>. A Mixed Document is a single or multipage PDF that contains more than one doc type. This array is optional and is only returned when the <<glossary:Book>> has Mixed Documents uploaded to it.",
                          "items": {
                            "type": "object",
                            "properties": {
                              "pk": {
                                "type": "integer",
                                "description": "Primary key of the Mixed Document.",
                                "example": 11565050
                              },
                              "id": {
                                "type": "integer",
                                "description": "ID of the Mixed Document (same as `pk`).",
                                "example": 11565050
                              },
                              "uuid": {
                                "type": "string",
                                "description": "UUID of the Mixed Document.",
                                "example": "a27ffbf5-7137-4a71-b1a9-65e256838cfb"
                              },
                              "name": {
                                "type": "string",
                                "description": "Name of the Mixed Document.",
                                "example": "paystubexample.pdf"
                              },
                              "md5": {
                                "type": "string",
                                "description": "MD5 checksum of the Mixed Document.",
                                "example": "88e004f15a4ca3dc057a0baf8dcd8774"
                              },
                              "pages": {
                                "type": "integer",
                                "description": "Number of pages in the Mixed Document.",
                                "example": 1
                              },
                              "status": {
                                "type": "string",
                                "description": "Processing status of the Mixed Document. Same enum as the DOC object.",
                                "example": "COMPLETED"
                              },
                              "image_group_pk": {
                                "type": "integer",
                                "nullable": true,
                                "description": "Primary key of the image group associated with the Mixed Document.",
                                "example": null
                              },
                              "document_class": {
                                "type": "string",
                                "description": "Document class indicating the processing type of the document.",
                                "enum": [
                                  "COMPLETE",
                                  "INSTANT"
                                ],
                                "example": null
                              },
                              "rejection_reason": {
                                "type": "string",
                                "nullable": true,
                                "description": "Rejection reason if the Mixed Document was rejected. Unlike `docs[]`, this field is always present — it returns `null` when the document has not been rejected.",
                                "example": null
                              }
                            }
                          }
                        }
                      }
                    },
                    "message": {
                      "type": "string",
                      "description": "A textual description that indicates details about this response's status.",
                      "example": "OK"
                    }
                  }
                },
                "examples": {
                  "Success": {
                    "value": {
                      "status": 200,
                      "response": {
                        "name": "Example Book",
                        "created": "2023-05-30T16:15:14Z",
                        "created_ts": "2023-05-30T16:15:13Z",
                        "pk": 34251191,
                        "owner_email": "email@address.com",
                        "is_public": true,
                        "uuid": "9ef345ab-33fe-4f0d-ad63-27c47f6419b3",
                        "id": 34251191,
                        "is_shared_or_public_book": true,
                        "docs": [
                          {
                            "pk": 55877634,
                            "name": "paystubexample.pdf(0)",
                            "uuid": "de548ffc-5df5-4bb4-b14a-42eb27c34364",
                            "pages": 1,
                            "md5": "88e004f15a4ca3dc057a0baf8dcd8774",
                            "status": "VERIFICATION_COMPLETE",
                            "document_class": "COMPLETE",
                            "image_group_pk": null,
                            "mixed_uploaded_doc_pk": 11565050
                          },
                          {
                            "pk": 55877318,
                            "name": "bankstatementexample.pdf(0)",
                            "uuid": "d0e386de-45f6-434a-a954-c66f6e30a5d4",
                            "pages": 1,
                            "md5": "e78045a805517d962fc78289d98b2573",
                            "status": "REJECTED",
                            "document_class": "INSTANT",
                            "image_group_pk": null,
                            "mixed_uploaded_doc_pk": 11564993,
                            "rejection_reason": "INVALID DOCUMENT",
                            "rejection_reason_description": "The document could not be processed."
                          }
                        ],
                        "mixed_docs": [
                          {
                            "pk": 11565050,
                            "name": "paystubexample.pdf",
                            "uuid": "a27ffbf5-7137-4a71-b1a9-65e256838cfb",
                            "id": 11565050,
                            "pages": 1,
                            "md5": "88e004f15a4ca3dc057a0baf8dcd8774",
                            "status": "COMPLETED",
                            "document_class": "COMPLETE",
                            "image_group_pk": null,
                            "rejection_reason": null
                          },
                          {
                            "pk": 11564993,
                            "name": "bankstatementexample.pdf",
                            "uuid": "e2deaa15-ad6a-4d09-83af-9395bc77fb96",
                            "id": 11564993,
                            "pages": 1,
                            "md5": "e78045a805517d962fc78289d98b2573",
                            "status": "COMPLETED",
                            "document_class": "COMPLETE",
                            "image_group_pk": null,
                            "rejection_reason": null
                          }
                        ],
                        "book_status": "VERIFIED",
                        "book_class": "COMPLETE"
                      },
                      "message": "OK"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Client Errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/paths/~1v1~1books/get/responses/400/content/application~1json/schema"
                },
                "examples": {
                  "Book not found": {
                    "value": {
                      "status": 400,
                      "code": 1401,
                      "response": null,
                      "message": "Book not found",
                      "meta": {
                        "status": 400,
                        "msg": "Book not found",
                        "code": 1401
                      }
                    }
                  },
                  "Missing Required Parameters": {
                    "value": {
                      "status": 400,
                      "code": 1103,
                      "response": null,
                      "message": "Required pk or book uuid",
                      "meta": {
                        "status": 400,
                        "msg": "Required pk or book uuid",
                        "code": 1103
                      }
                    }
                  },
                  "No Permission": {
                    "value": {
                      "status": 400,
                      "code": 2102,
                      "response": null,
                      "message": "No permission to access this book",
                      "meta": {
                        "status": 400,
                        "msg": "No permission to access this book",
                        "code": 2102
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/paths/~1v1~1books/get/responses/500/content/application~1json/schema"
                },
                "examples": {
                  "Internal Server Error": {
                    "value": {
                      "status": 500,
                      "message": "Internal Server Error."
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "oauth": {
        "type": "oauth2",
        "description": "OAuth 2.0 support via client credentials flow. See [here](doc:using-api-credentials) for usage information.\n",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://auth.ocrolus.com/oauth/token",
            "scopes": {}
          }
        }
      }
    }
  }
}
```