Getting started with bank statements

Upload, capture, and analyze a bank statement.

This tutorial demonstrates how to upload, capture, and analyze a sample bank statement (see below). Upon completion of this tutorial, you will have detailed information and analysis about the bank statement in structured data. You may use your own bank statement to complete this tutorial, but the examples refer to the sample bank statement below.

This tutorial assumes a working knowledge of curl.

Setting up authentication

Before you use the Ocrolus API, you'll need to create a set of authentication credentials with the following steps:

  1. Log in to the Ocrolus Dashboard.
  2. Navigate to the API Credentials tab.
  3. Add a new pair of credentials with the Add OAuth 2.0 API Credentials button.
  4. Follow the instructions given in the window that pops up.

You can find a full description of this process here.

Using the code samples

📘

To run test requests:

  1. Login to your account and create a authentication header.
  2. Copy the cURL examples below.
    • Replace the authentication example (--header 'Authorization: Bearer ZGV2ZWxvcGVyQG9jcm9sdXMuY29tOm15UGFzc3dvcmQ=') with your authentication header.
    • Replace any other parameters as indicated.

Upload

Uploading a document consists of two parts:

  1. Create a Book
  2. Add bank statement to your Book

Create a Book

Before uploading documents with Ocrolus, you must create a Book. Books are used to contain multiple documents, allowing you to store and analyze multiple documents as a unit.

To create a new Book, follow the steps below:

  1. Send a POST request to the Create a Book endpoint.
    • Include your authentication header
    • Include the name of your Book in the body of the request. In the example below the Book is called Sample bank statement.

Example request

curl --location 'https://api.ocrolus.com/v1/book/add' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6ImVDRnR4MXFtcGprYzdzT2FDUUZiVCJ9.eyJodHRwczovL2NsYWltcy5vY3JvbHVzLmNvbS9hY2NvdW50X3BrIjoiMTg5NzYiLCJodHRwczovL2NsYWltcy5vY3JvbHVzLmNvbS9vcmdfaW5mb19wayI6IjQwMDUiLCJodHRwczovL2NsYWltcy5vY3JvbHVzLmNvbS9lbWFpbCI6ImtzaW5naDErZGVtb0BvY3JvbHVzLmNvbSIsImlzcyI6Imh0dHBzOi8vYXV0aC5vY3JvbHVzLmNvbS8iLCJzdWIiOiI5aHppYTRJUDRxYTlQTGFzT25BYUw2ZzNVM014b3JPOEBjbGllbnRzIiwiYXVkIjoiaHR0cHM6Ly9hcGkub2Nyb2x1cy5jb20vIiwiaWF0IjoxNjc3ODE3OTcxLCJleHAiOjE2Nzc5MDQzNzEsImF6cCI6IjloemlhNElQNHFhOVBMYXNPbkFhTDZnM1UzTXhvck84IiwiZ3R5IjoiY2xpZW50LWNyZWRlbnRpYWxzIn0.eH8l6z0F8W5BPCEG0yVz919lYgQ_c9GUMheR096-UTcQCaxorjNjq567vY-f95yKdajBvsa_1SX6VB48bBA9MUDjGZwRY2oqfyuza2ola1CHb0ktn2Y2VEEukjgvvtR4AftaRnlSGzmWxA6MfZM-NdUVXfCtR8JpnqsK48PfclwvFX3r9FqOQkFmO5xmrbGcz2z0Dbkl6quKziiAM4d-mFt6_iJKQgmlQGE9R1FZGOkQ8kRzE2TjY9WFvoRzHamKqOnE6aa5sEb9ABl-MVZl-txSYlsFmyM6q9UXSvuzBUhyJStpW0L3Nhc9_qYSB-wNB--Sejb1E_fBcG7hDvPFUQ' \
--form 'is_public="true"' \
--form 'name="Sample bank statement"'
  1. A successful response will include the Book UUID key. This is the unique identifier used to access the Book in other requests.

Example 200 response

{
    "status": 200,
    "response": {
        "name": "Sample bank statement",
        "created": "2023-03-03T04:36:31Z",
        "created_ts": "2023-03-03T04:36:31Z",
        "pk": 30219565,
        "owner_email": "[email protected]",
        "is_public": true,
        "uuid": "19aab921-25a5-4beb-a59e-ac72320061d6",
        "id": 30219565
    },
    "message": "OK"
}
  1. Note the Book UUID (response.uuid) value. It will be used in the next step.

Add bank statement to your Book

Once the Book has successfully been created, you are ready to start adding documents. To upload the example bank statement to your Book, follow the steps below:

  1. Download the example bank statement.
  2. Send a POST request to the Upload PDF to Book endpoint.
    • Include your authentication header.
    • Include the bank statement as form data in the request payload. (See our multipart/form-data Payloads tutorial if you need help formatting this request).
    • Include the Book UUID (book_uuid) value as form data in the payload.

Example request

curl --location 'https://api.ocrolus.com/v1/book/upload' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6ImVDRnR4MXFtcGprYzdzT2FDUUZiVCJ9.eyJodHRwczovL2NsYWltcy5vY3JvbHVzLmNvbS9hY2NvdW50X3BrIjoiMTg5NzYiLCJodHRwczovL2NsYWltcy5vY3JvbHVzLmNvbS9vcmdfaW5mb19wayI6IjQwMDUiLCJodHRwczovL2NsYWltcy5vY3JvbHVzLmNvbS9lbWFpbCI6ImtzaW5naDErZGVtb0BvY3JvbHVzLmNvbSIsImlzcyI6Imh0dHBzOi8vYXV0aC5vY3JvbHVzLmNvbS8iLCJzdWIiOiI5aHppYTRJUDRxYTlQTGFzT25BYUw2ZzNVM014b3JPOEBjbGllbnRzIiwiYXVkIjoiaHR0cHM6Ly9hcGkub2Nyb2x1cy5jb20vIiwiaWF0IjoxNjc3ODE3OTcxLCJleHAiOjE2Nzc5MDQzNzEsImF6cCI6IjloemlhNElQNHFhOVBMYXNPbkFhTDZnM1UzTXhvck84IiwiZ3R5IjoiY2xpZW50LWNyZWRlbnRpYWxzIn0.eH8l6z0F8W5BPCEG0yVz919lYgQ_c9GUMheR096-UTcQCaxorjNjq567vY-f95yKdajBvsa_1SX6VB48bBA9MUDjGZwRY2oqfyuza2ola1CHb0ktn2Y2VEEukjgvvtR4AftaRnlSGzmWxA6MfZM-NdUVXfCtR8JpnqsK48PfclwvFX3r9FqOQkFmO5xmrbGcz2z0Dbkl6quKziiAM4d-mFt6_iJKQgmlQGE9R1FZGOkQ8kRzE2TjY9WFvoRzHamKqOnE6aa5sEb9ABl-MVZl-txSYlsFmyM6q9UXSvuzBUhyJStpW0L3Nhc9_qYSB-wNB--Sejb1E_fBcG7hDvPFUQ' \
--form 'upload=@"/Users/ocrolus/Downloads/Sample bank statement.pdf"' \
--form 'book_uuid="19aab921-25a5-4beb-a59e-ac72320061d6"'
  1. A successful response will return an array containing information about the document uploaded to the Book.

Example 200 response

{
    "status": 200,
    "response": {
        "uploaded_docs": [
            {
                "pk": 52386256,
                "uuid": "4ad17d9e-1963-44c3-b709-2c5c80b9d667",
                "name": "Sample bank statement.pdf",
                "page_count": 3,
                "checksum": "b1dcf0608555e1309cec2e9afda5205c",
                "created_ts": "2023-03-03T05:09:18Z",
                "id": 52386256
            }
        ]
    },
    "message": "OK"
}

Check document status (optional)

For testing purposes, it can be helpful to check the status of the documents uploaded in your Book. This step is optional. Its use is discouraged in a production workflow. Each document may have one status included in the Document Status table:

To check the status of your document, follow the steps below.

  1. Send a GET request to the Book Status endpoint.
  2. Include your authentication header.
  3. Include the Book's primary key in the body of your request.

Example request

curl --request GET \
    --url https://api.ocrolus.com/v1/book/status \
    --header 'Content-Type: application/json'
    --header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6ImVDRnR4MXFtcGprYzdzT2FDUUZiVCJ9.eyJodHRwczovL2NsYWltcy5vY3JvbHVzLmNvbS9hY2NvdW50X3BrIjoiMTg5NzYiLCJodHRwczovL2NsYWltcy5vY3JvbHVzLmNvbS9vcmdfaW5mb19wayI6IjQwMDUiLCJodHRwczovL2NsYWltcy5vY3JvbHVzLmNvbS9lbWFpbCI6ImtzaW5naDErZGVtb0BvY3JvbHVzLmNvbSIsImlzcyI6Imh0dHBzOi8vYXV0aC5vY3JvbHVzLmNvbS8iLCJzdWIiOiI5aHppYTRJUDRxYTlQTGFzT25BYUw2ZzNVM014b3JPOEBjbGllbnRzIiwiYXVkIjoiaHR0cHM6Ly9hcGkub2Nyb2x1cy5jb20vIiwiaWF0IjoxNjc3ODE3OTcxLCJleHAiOjE2Nzc5MDQzNzEsImF6cCI6IjloemlhNElQNHFhOVBMYXNPbkFhTDZnM1UzTXhvck84IiwiZ3R5IjoiY2xpZW50LWNyZWRlbnRpYWxzIn0.eH8l6z0F8W5BPCEG0yVz919lYgQ_c9GUMheR096-UTcQCaxorjNjq567vY-f95yKdajBvsa_1SX6VB48bBA9MUDjGZwRY2oqfyuza2ola1CHb0ktn2Y2VEEukjgvvtR4AftaRnlSGzmWxA6MfZM-NdUVXfCtR8JpnqsK48PfclwvFX3r9FqOQkFmO5xmrbGcz2z0Dbkl6quKziiAM4d-mFt6_iJKQgmlQGE9R1FZGOkQ8kRzE2TjY9WFvoRzHamKqOnE6aa5sEb9ABl-MVZl-txSYlsFmyM6q9UXSvuzBUhyJStpW0L3Nhc9_qYSB-wNB--Sejb1E_fBcG7hDvPFUQ' \
    --data '{
        "pk": "30219565"
    }'
  1. A successful response will return an array containing information about each document in the Book.

Example 200 response

{
    "status": 200,
    "response": {
        "name": "Sample bank statement",
        "created": "2023-03-03T04:36:31Z",
        "created_ts": "2023-03-03T04:36:31Z",
        "pk": 30219565,
        "owner_email": "[email protected]",
        "is_public": true,
        "uuid": "19aab921-25a5-4beb-a59e-ac72320061d6",
        "id": 30219565,
        "is_shared_or_public_book": true,
        "docs": [
            {
                "pk": 52386256,
                "name": "Sample bank statement.pdf",
                "uuid": "4ad17d9e-1963-44c3-b709-2c5c80b9d667",
                "pages": 3,
                "md5": "b1dcf0608555e1309cec2e9afda5205c",
                "status": "VERIFICATION_COMPLETE",
                "image_group_pk": null,
                "mixed_uploaded_doc_pk": null
            }
        ],
        "mixed_docs": [],
        "book_status": "VERIFIED"
    },
    "message": "OK"
}
  1. Find the desired document in the documents array.
    a. See the array of documents in the response (response.docs)
    b. Find the bank statement in the array. (You can do this by finding the object with the correct name (name), primary key (pk), or Book UUID (uuid)).

In the example above, our document is the first item in the array. This means you can check the status by looking at the value in response.docs[0].status.

📘

How long?

Turnaround time for document upload depends on several factors, including document quality, document source, and whether fraud or suspicious activity is detected. In general, analytics data will be ready to download within a few minutes.

Capture

Extract data from the uploaded documents. For the sample bank statement, you can view the full transaction list:

The steps below demonstrate how to request the full transaction list:

  1. Send a GET request to the Transactions endpoint.
  2. Include your authentication header.
  3. Include the Book's primary key in the body of your request.

Example request

curl --request GET \
    --url https://api.ocrolus.com/v1/transaction \
    --header 'Authorization: Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6ImVDRnR4MXFtcGprYzdzT2FDUUZiVCJ9.eyJodHRwczovL2NsYWltcy5vY3JvbHVzLmNvbS9hY2NvdW50X3BrIjoiMTg5NzYiLCJodHRwczovL2NsYWltcy5vY3JvbHVzLmNvbS9vcmdfaW5mb19wayI6IjQwMDUiLCJodHRwczovL2NsYWltcy5vY3JvbHVzLmNvbS9lbWFpbCI6ImtzaW5naDErZGVtb0BvY3JvbHVzLmNvbSIsImlzcyI6Imh0dHBzOi8vYXV0aC5vY3JvbHVzLmNvbS8iLCJzdWIiOiI5aHppYTRJUDRxYTlQTGFzT25BYUw2ZzNVM014b3JPOEBjbGllbnRzIiwiYXVkIjoiaHR0cHM6Ly9hcGkub2Nyb2x1cy5jb20vIiwiaWF0IjoxNjc3ODE3OTcxLCJleHAiOjE2Nzc5MDQzNzEsImF6cCI6IjloemlhNElQNHFhOVBMYXNPbkFhTDZnM1UzTXhvck84IiwiZ3R5IjoiY2xpZW50LWNyZWRlbnRpYWxzIn0.eH8l6z0F8W5BPCEG0yVz919lYgQ_c9GUMheR096-UTcQCaxorjNjq567vY-f95yKdajBvsa_1SX6VB48bBA9MUDjGZwRY2oqfyuza2ola1CHb0ktn2Y2VEEukjgvvtR4AftaRnlSGzmWxA6MfZM-NdUVXfCtR8JpnqsK48PfclwvFX3r9FqOQkFmO5xmrbGcz2z0Dbkl6quKziiAM4d-mFt6_iJKQgmlQGE9R1FZGOkQ8kRzE2TjY9WFvoRzHamKqOnE6aa5sEb9ABl-MVZl-txSYlsFmyM6q9UXSvuzBUhyJStpW0L3Nhc9_qYSB-wNB--Sejb1E_fBcG7hDvPFUQ' \
    --header 'Content-Type: application/json' \
    --data '{
        "book_pk" : "30219565"
    }'
  1. A successful response will return an array of transactions from the document.

Example 200 response

{
   "status": 200,
   "response": {
       "txns": [
           {
               "page_idx": 0,
               "bank_account_pk": 13402218,
               "amount": "450.00",
               "bbox": [
                   142,
                   2808,
                   2200,
                   2846
               ],
               "txn_date": "08/10/2020",
               "page_doc_pk": 314888744,
               "pk": 3707780609,
               "uploaded_doc_pk": 52386256,
               "description": "CHASE ATM 08/10 # 000002667 DEPOSIT 1608 AVE M BROOKLYN NY",
               "txn_pk_duplicate_of": null,
               "comment": "",
               "explanation": "",
               "has_probable_transfers": false,
               "tags": {},
               "period_pk": 38752257
           },
           {
               "page_idx": 0,
               "bank_account_pk": 13402218,
               "amount": "-325.00",
               "bbox": [
                   146,
                   3058,
                   2204,
                   3100
               ],
               "txn_date": "08/12/2020",
               "page_doc_pk": 314888744,
               "pk": 3707780606,
               "uploaded_doc_pk": 52386256,
               "description": "CHECKCARD 0812 LIBERTY PAPER SUPPLIES # 633 COURT ST [... ]",
               "txn_pk_duplicate_of": null,
               "comment": "",
               "explanation": "",
               "has_probable_transfers": false,
               "tags": {},
               "period_pk": 38752257
           },
           {
               "page_idx": 0,
               "bank_account_pk": 13402218,
               "amount": "275.65",
               "bbox": [
                   142,
                   2975,
                   2200,
                   3017
               ],
               "txn_date": "08/12/2020",
               "page_doc_pk": 314888744,
               "pk": 3707780607,
               "uploaded_doc_pk": 52386256,
               "description": "Square Inc DES * Cash App ID: T210623548125 INDN: Jill Smith CO [... ]",
               "txn_pk_duplicate_of": null,
               "comment": "",
               "explanation": "",
               "has_probable_transfers": false,
               "tags": {},
               "period_pk": 38752257
           },
           {
               "page_idx": 0,
               "bank_account_pk": 13402218,
               "amount": "600.00",
               "bbox": [
                   142,
                   2892,
                   2200,
                   2929
               ],
               "txn_date": "08/12/2020",
               "page_doc_pk": 314888744,
               "pk": 3707780608,
               "uploaded_doc_pk": 52386256,
               "description": "CHASE ATM 08/12 # 000002686 DEPOSIT 1608 AVE M BROOKLYN NY",
               "txn_pk_duplicate_of": null,
               "comment": "",
               "explanation": "",
               "has_probable_transfers": false,
               "tags": {},
               "period_pk": 38752257
           },
           {
               "page_idx": 0,
               "bank_account_pk": 13402218,
               "amount": "-1235.47",
               "bbox": [
                   142,
                   3225,
                   2204,
                   3271
               ],
               "txn_date": "08/13/2020",
               "page_doc_pk": 314888744,
               "pk": 3707780604,
               "uploaded_doc_pk": 52386256,
               "description": "CHECKCARD 0813 TUNA MED FOOD BROOKLYN NY 12294650031344735553451",
               "txn_pk_duplicate_of": null,
               "comment": "",
               "explanation": "",
               "has_probable_transfers": false,
               "tags": {},
               "period_pk": 38752257
           },
           {
               "page_idx": 0,
               "bank_account_pk": 13402218,
               "amount": "90.00",
               "bbox": [
                   142,
                   3142,
                   2200,
                   3183
               ],
               "txn_date": "08/13/2020",
               "page_doc_pk": 314888744,
               "pk": 3707780605,
               "uploaded_doc_pk": 52386256,
               "description": "Online Banking transfer from CHK 2580 Confimation # 2351315828",
               "txn_pk_duplicate_of": null,
               "comment": "",
               "explanation": "",
               "has_probable_transfers": false,
               "tags": {},
               "period_pk": 38752257
           },
           {
               "page_idx": 1,
               "bank_account_pk": 13402218,
               "amount": "-227.14",
               "bbox": [
                   142,
                   704,
                   2200,
                   742
               ],
               "txn_date": "08/15/2020",
               "page_doc_pk": 314888745,
               "pk": 3707780621,
               "uploaded_doc_pk": 52386256,
               "description": "CHECKCARD 0815 NGUYEN COFFEE SUPPLY # 341 KNICKERBOCKER AVE [",
               "txn_pk_duplicate_of": null,
               "comment": "",
               "explanation": "",
               "has_probable_transfers": false,
               "tags": {},
               "period_pk": 38752257
           },
           {
               "page_idx": 0,
               "bank_account_pk": 13402218,
               "amount": "550.00",
               "bbox": [
                   142,
                   3308,
                   2200,
                   3350
               ],
               "txn_date": "08/15/2020",
               "page_doc_pk": 314888744,
               "pk": 3707780603,
               "uploaded_doc_pk": 52386256,
               "description": "CHASE ATM 08/15 # 000002687 DEPOSIT 1608 AVE M BROOKLYN NY",
               "txn_pk_duplicate_of": null,
               "comment": "",
               "explanation": "",
               "has_probable_transfers": false,
               "tags": {},
               "period_pk": 38752257
           },
           {
               "page_idx": 1,
               "bank_account_pk": 13402218,
               "amount": "893.44",
               "bbox": [
                   142,
                   788,
                   2200,
                   829
               ],
               "txn_date": "08/16/2020",
               "page_doc_pk": 314888745,
               "pk": 3707780620,
               "uploaded_doc_pk": 52386256,
               "description": "Venmo Cashout PPD ID: 3592118565",
               "txn_pk_duplicate_of": null,
               "comment": "",
               "explanation": "",
               "has_probable_transfers": false,
               "tags": {},
               "period_pk": 38752257
           },
           {
               "page_idx": 1,
               "bank_account_pk": 13402218,
               "amount": "450.00",
               "bbox": [
                   138,
                   871,
                   2204,
                   913
               ],
               "txn_date": "08/17/2020",
               "page_doc_pk": 314888745,
               "pk": 3707780619,
               "uploaded_doc_pk": 52386256,
               "description": "CHASE ATM 08/17 # 000002717 DEPOSIT 1608 AVE M BROOKLYN NY",
               "txn_pk_duplicate_of": null,
               "comment": "",
               "explanation": "",
               "has_probable_transfers": false,
               "tags": {},
               "period_pk": 38752257
           },
           {
               "page_idx": 1,
               "bank_account_pk": 13402218,
               "amount": "-6.14",
               "bbox": [
                   142,
                   954,
                   2200,
                   992
               ],
               "txn_date": "08/17/2020",
               "page_doc_pk": 314888745,
               "pk": 3707780618,
               "uploaded_doc_pk": 52386256,
               "description": "CHECKCARD 0817 PUBLIX # 228 BROOKLYN NY 15203341941830373962756",
               "txn_pk_duplicate_of": null,
               "comment": "",
               "explanation": "",
               "has_probable_transfers": false,
               "tags": {},
               "period_pk": 38752257
           },
           {
               "page_idx": 1,
               "bank_account_pk": 13402218,
               "amount": "-4000.00",
               "bbox": [
                   142,
                   1038,
                   2200,
                   1079
               ],
               "txn_date": "08/19/2020",
               "page_doc_pk": 314888745,
               "pk": 3707780617,
               "uploaded_doc_pk": 52386256,
               "description": "Online Banking Transfer to CHK 8759 Confirmation # 2454385332",
               "txn_pk_duplicate_of": null,
               "comment": "",
               "explanation": "",
               "has_probable_transfers": false,
               "tags": {},
               "period_pk": 38752257
           },
           {
               "page_idx": 1,
               "bank_account_pk": 13402218,
               "amount": "-10.75",
               "bbox": [
                   142,
                   1117,
                   2204,
                   1167
               ],
               "txn_date": "08/21/2020",
               "page_doc_pk": 314888745,
               "pk": 3707780616,
               "uploaded_doc_pk": 52386256,
               "description": "MTA * METROCARD 08/21 # 000003214 PURCHASE MTA * METROCARD / PAT [...",
               "txn_pk_duplicate_of": null,
               "comment": "",
               "explanation": "",
               "has_probable_transfers": false,
               "tags": {},
               "period_pk": 38752257
           },
           {
               "page_idx": 1,
               "bank_account_pk": 13402218,
               "amount": "-54.25",
               "bbox": [
                   142,
                   1200,
                   2200,
                   1254
               ],
               "txn_date": "08/23/2020",
               "page_doc_pk": 314888745,
               "pk": 3707780615,
               "uploaded_doc_pk": 52386256,
               "description": "Medra H 08/23 # 000315425 WITHDRWL 789 Broad Street BROOKLYN NY",
               "txn_pk_duplicate_of": null,
               "comment": "",
               "explanation": "",
               "has_probable_transfers": false,
               "tags": {},
               "period_pk": 38752257
           },
           {
               "page_idx": 1,
               "bank_account_pk": 13402218,
               "amount": "-12.42",
               "bbox": [
                   142,
                   1288,
                   2200,
                   1329
               ],
               "txn_date": "08/28/2020",
               "page_doc_pk": 314888745,
               "pk": 3707780614,
               "uploaded_doc_pk": 52386256,
               "description": "CHECKCARD 0623 2 FRIENDS DELI & GROCER BROOKLYN NY [... ]",
               "txn_pk_duplicate_of": null,
               "comment": "",
               "explanation": "",
               "has_probable_transfers": false,
               "tags": {},
               "period_pk": 38752257
           },
           {
               "page_idx": 1,
               "bank_account_pk": 13402218,
               "amount": "29.00",
               "bbox": [
                   142,
                   1371,
                   2204,
                   1413
               ],
               "txn_date": "09/04/2020",
               "page_doc_pk": 314888745,
               "pk": 3707780613,
               "uploaded_doc_pk": 52386256,
               "description": "Online Banking transfer from CHK 2580 Confimation # 2415004514",
               "txn_pk_duplicate_of": null,
               "comment": "",
               "explanation": "",
               "has_probable_transfers": false,
               "tags": {},
               "period_pk": 38752257
           },
           {
               "page_idx": 1,
               "bank_account_pk": 13402218,
               "amount": "-31.01",
               "bbox": [
                   142,
                   1538,
                   2200,
                   1579
               ],
               "txn_date": "09/07/2020",
               "page_doc_pk": 314888745,
               "pk": 3707780611,
               "uploaded_doc_pk": 52386256,
               "description": "Online Banking transfer to CHK 2580 Confirmation # 1326566495",
               "txn_pk_duplicate_of": null,
               "comment": "",
               "explanation": "",
               "has_probable_transfers": false,
               "tags": {},
               "period_pk": 38752257
           },
           {
               "page_idx": 1,
               "bank_account_pk": 13402218,
               "amount": "-1.99",
               "bbox": [
                   142,
                   1454,
                   2200,
                   1492
               ],
               "txn_date": "09/07/2020",
               "page_doc_pk": 314888745,
               "pk": 3707780612,
               "uploaded_doc_pk": 52386256,
               "description": "CHECKCARD 0907 GOOGLE * Google Mount ViewLA",
               "txn_pk_duplicate_of": null,
               "comment": "",
               "explanation": "",
               "has_probable_transfers": false,
               "tags": {},
               "period_pk": 38752257
           },
           {
               "page_idx": 1,
               "bank_account_pk": 13402218,
               "amount": "-63.14",
               "bbox": [
                   142,
                   1621,
                   2208,
                   1658
               ],
               "txn_date": "09/08/2020",
               "page_doc_pk": 314888745,
               "pk": 3707780610,
               "uploaded_doc_pk": 52386256,
               "description": "CHECKCARD 0623 2 FRIENDS DELI & GROCER BROOKLYN NY [... ]",
               "txn_pk_duplicate_of": null,
               "comment": "",
               "explanation": "",
               "has_probable_transfers": false,
               "tags": {},
               "period_pk": 38752257
           }
       ],
       "uploaded_docs": {
           "52386256": {
               "name": "Sample bank statement.pdf",
               "status": "VERIFICATION_COMPLETE",
               "pages": 3,
               "pk": 52386256,
               "uuid": "4ad17d9e196344c3b7092c5c80b9d667"
           }
       },
       "bank_accounts": {
           "13402218": {
               "pk": 13402218,
               "book_pk": 30219565,
               "name": "381053654285 CHASE SAVINGS",
               "bank_name": "CHASE",
               "activity_info": {
                   "active": [
                       {
                           "start": {
                               "year": 2020,
                               "month": 8,
                               "day": 10
                           },
                           "end": {
                               "year": 2020,
                               "month": 9,
                               "day": 9
                           }
                       }
                   ],
                   "missing": []
               },
               "account_type": "SAVINGS",
               "account_holder": "JILL SMITH",
               "account_number": "381053654285",
               "holder_zip": "11215",
               "holder_country": "US",
               "holder_state": "NY",
               "holder_city": "New York",
               "holder_address_1": "307 8TH AVENUE PARK SLOPE",
               "holder_address_2": "APARTMENT 3B",
               "account_category": "PERSONAL ACCOUNT",
               "id": 13402218,
               "book_uuid": "19aab92125a54beba59eac72320061d6",
               "periods": [
                   {
                       "pk": 38752257,
                       "uuid": "5b30b03a-d478-48e0-8873-ea8b942350a2",
                       "bank_account_pk": 13402218,
                       "begin_date": "08/10/2020",
                       "end_date": "09/09/2020",
                       "begin_balance": "23614.24",
                       "end_balance": "20985.02",
                       "primary_recon_error_reason": null,
                       "secondary_recon_error_reason": null,
                       "uploaded_doc_pk": 52386256
                   }
               ],
               "account_holders": [
                   "JILL SMITH"
               ]
           }
       },
       "tags": {}
   },
   "message": "OK"
}

Analyze

View analytics on the extracted data from uploaded documents.

📘

Note:

The steps below demonstrate how to download analytics synchronously. If desired, you may also download analytics asynchronously. Make sure you have set up webhooks.

Download analyzed bank statement data

Once the uploaded data has been analyzed by Ocrolus, you can download the results. You may download data in JSON or XSV format.

The following example shows how to download analytics in JSON format.

  1. Send a GET request to the Analytics (JSON) endpoint.
  2. Include your authentication header.
  3. Include the Book's primary key in the body of your request.

Example request

curl --location 'https://api.ocrolus.com/v1/book/summary' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6ImVDRnR4MXFtcGprYzdzT2FDUUZiVCJ9.eyJodHRwczovL2NsYWltcy5vY3JvbHVzLmNvbS9hY2NvdW50X3BrIjoiMTg5NzYiLCJodHRwczovL2NsYWltcy5vY3JvbHVzLmNvbS9vcmdfaW5mb19wayI6IjQwMDUiLCJodHRwczovL2NsYWltcy5vY3JvbHVzLmNvbS9lbWFpbCI6ImtzaW5naDErZGVtb0BvY3JvbHVzLmNvbSIsImlzcyI6Imh0dHBzOi8vYXV0aC5vY3JvbHVzLmNvbS8iLCJzdWIiOiI5aHppYTRJUDRxYTlQTGFzT25BYUw2ZzNVM014b3JPOEBjbGllbnRzIiwiYXVkIjoiaHR0cHM6Ly9hcGkub2Nyb2x1cy5jb20vIiwiaWF0IjoxNjc3ODE3OTcxLCJleHAiOjE2Nzc5MDQzNzEsImF6cCI6IjloemlhNElQNHFhOVBMYXNPbkFhTDZnM1UzTXhvck84IiwiZ3R5IjoiY2xpZW50LWNyZWRlbnRpYWxzIn0.eH8l6z0F8W5BPCEG0yVz919lYgQ_c9GUMheR096-UTcQCaxorjNjq567vY-f95yKdajBvsa_1SX6VB48bBA9MUDjGZwRY2oqfyuza2ola1CHb0ktn2Y2VEEukjgvvtR4AftaRnlSGzmWxA6MfZM-NdUVXfCtR8JpnqsK48PfclwvFX3r9FqOQkFmO5xmrbGcz2z0Dbkl6quKziiAM4d-mFt6_iJKQgmlQGE9R1FZGOkQ8kRzE2TjY9WFvoRzHamKqOnE6aa5sEb9ABl-MVZl-txSYlsFmyM6q9UXSvuzBUhyJStpW0L3Nhc9_qYSB-wNB--Sejb1E_fBcG7hDvPFUQ'
--data '{
        "pk" : "30219565"
    }'
  1. A successful response will return the analytics.

Example 200 response

{
    "status": 200,
    "response": {
        "negative_balances_by_month_weekday": {
            "08/2020": [],
            "09/2020": []
        },
        "alt_lender_payments_by_month": {
            "08/2020": "0.00",
            "09/2020": "0.00"
        },
        "deposit_count": 8,
        "daily_balances": {
            "08/10/2020": "24064.24",
            "08/11/2020": "24064.24",
            "08/12/2020": "24614.89",
            "08/13/2020": "23469.42",
            "08/14/2020": "23469.42",
            "08/15/2020": "23792.28",
            "08/16/2020": "24685.72",
            "08/17/2020": "25129.58",
            "08/18/2020": "25129.58",
            "08/19/2020": "21129.58",
            "08/20/2020": "21129.58",
            "08/21/2020": "21118.83",
            "08/22/2020": "21118.83",
            "08/23/2020": "21064.58",
            "08/24/2020": "21064.58",
            "08/25/2020": "21064.58",
            "08/26/2020": "21064.58",
            "08/27/2020": "21064.58",
            "08/28/2020": "21052.16",
            "08/29/2020": "21052.16",
            "08/30/2020": "21052.16",
            "08/31/2020": "21052.16",
            "09/01/2020": "21052.16",
            "09/02/2020": "21052.16",
            "09/03/2020": "21052.16",
            "09/04/2020": "21081.16",
            "09/05/2020": "21081.16",
            "09/06/2020": "21081.16",
            "09/07/2020": "21048.16",
            "09/08/2020": "20985.02",
            "09/09/2020": "20985.02"
        },
        "estimated_revenue_by_month": {
            "08/2020": "3219.09",
            "09/2020": "0.00"
        },
        "deposit_sum": "3338.09",
        "estimated_expense_by_month": {
            "08/2020": "1871.17",
            "09/2020": "65.13"
        },
        "daily_balances_weekday_by_month": {
            "08/2020": {
                "08/10/2020": "24064.24",
                "08/11/2020": "24064.24",
                "08/12/2020": "24614.89",
                "08/13/2020": "23469.42",
                "08/14/2020": "23469.42",
                "08/17/2020": "25129.58",
                "08/18/2020": "25129.58",
                "08/19/2020": "21129.58",
                "08/20/2020": "21129.58",
                "08/21/2020": "21118.83",
                "08/24/2020": "21064.58",
                "08/25/2020": "21064.58",
                "08/26/2020": "21064.58",
                "08/27/2020": "21064.58",
                "08/28/2020": "21052.16",
                "08/31/2020": "21052.16"
            },
            "09/2020": {
                "09/01/2020": "21052.16",
                "09/02/2020": "21052.16",
                "09/03/2020": "21052.16",
                "09/04/2020": "21081.16",
                "09/07/2020": "21048.16",
                "09/08/2020": "20985.02",
                "09/09/2020": "20985.02"
            }
        },
        "average_daily_balance_by_month": {
            "08/2020": "22383.99",
            "09/2020": "21046.46"
        },
        "mca_payments_by_month": {
            "08/2020": "0.00",
            "09/2020": "0.00"
        },
        "txn_count": 19,
        "withdrawal_count": 11,
        "average_daily_balance": "21995.67",
        "daily_balances_weekday": {
            "08/10/2020": "24064.24",
            "08/11/2020": "24064.24",
            "08/12/2020": "24614.89",
            "08/13/2020": "23469.42",
            "08/14/2020": "23469.42",
            "08/17/2020": "25129.58",
            "08/18/2020": "25129.58",
            "08/19/2020": "21129.58",
            "08/20/2020": "21129.58",
            "08/21/2020": "21118.83",
            "08/24/2020": "21064.58",
            "08/25/2020": "21064.58",
            "08/26/2020": "21064.58",
            "08/27/2020": "21064.58",
            "08/28/2020": "21052.16",
            "08/31/2020": "21052.16",
            "09/01/2020": "21052.16",
            "09/02/2020": "21052.16",
            "09/03/2020": "21052.16",
            "09/04/2020": "21081.16",
            "09/07/2020": "21048.16",
            "09/08/2020": "20985.02",
            "09/09/2020": "20985.02"
        },
        "estimated_daily_expense_by_month": {
            "08/2020": "60.36",
            "09/2020": "2.17"
        },
        "average_deposit_by_month": {
            "09/2020": "29.00",
            "08/2020": "472.73"
        },
        "withdrawal_sum": "-5967.31",
        "cash_expense_days_by_month": {
            "08/2020": "370.84",
            "09/2020": "9698.83"
        },
        "negative_balances_by_month": {
            "08/2020": [],
            "09/2020": []
        },
        "daily_balances_by_month": {
            "08/2020": {
                "08/10/2020": "24064.24",
                "08/11/2020": "24064.24",
                "08/12/2020": "24614.89",
                "08/13/2020": "23469.42",
                "08/14/2020": "23469.42",
                "08/15/2020": "23792.28",
                "08/16/2020": "24685.72",
                "08/17/2020": "25129.58",
                "08/18/2020": "25129.58",
                "08/19/2020": "21129.58",
                "08/20/2020": "21129.58",
                "08/21/2020": "21118.83",
                "08/22/2020": "21118.83",
                "08/23/2020": "21064.58",
                "08/24/2020": "21064.58",
                "08/25/2020": "21064.58",
                "08/26/2020": "21064.58",
                "08/27/2020": "21064.58",
                "08/28/2020": "21052.16",
                "08/29/2020": "21052.16",
                "08/30/2020": "21052.16",
                "08/31/2020": "21052.16"
            },
            "09/2020": {
                "09/01/2020": "21052.16",
                "09/02/2020": "21052.16",
                "09/03/2020": "21052.16",
                "09/04/2020": "21081.16",
                "09/05/2020": "21081.16",
                "09/06/2020": "21081.16",
                "09/07/2020": "21048.16",
                "09/08/2020": "20985.02",
                "09/09/2020": "20985.02"
            }
        },
        "average_by_month": {
            "09/2020": "31.28",
            "08/2020": "612.02"
        },
        "pk": 30219565,
        "name": "Sample bank statement",
        "bank_accounts": [
            {
                "pk": 13402218,
                "book_pk": 30219565,
                "name": "381053654285 CHASE SAVINGS",
                "bank_name": "CHASE",
                "activity_info": {
                    "active": [
                        {
                            "start": {
                                "year": 2020,
                                "month": 8,
                                "day": 10
                            },
                            "end": {
                                "year": 2020,
                                "month": 9,
                                "day": 9
                            }
                        }
                    ],
                    "missing": []
                },
                "account_type": "SAVINGS",
                "account_holder": "JILL SMITH",
                "account_number": "381053654285",
                "holder_zip": "11215",
                "holder_country": "US",
                "holder_state": "NY",
                "holder_city": "New York",
                "holder_address_1": "307 8TH AVENUE PARK SLOPE",
                "holder_address_2": "APARTMENT 3B",
                "account_category": "PERSONAL ACCOUNT",
                "id": 13402218,
                "periods": [
                    {
                        "period_month_txns": {
                            "08/2020": 15,
                            "09/2020": 4
                        },
                        "period_month_days": {
                            "08/2020": 16,
                            "09/2020": 7
                        },
                        "pk": 38752257,
                        "uuid": "5b30b03a-d478-48e0-8873-ea8b942350a2",
                        "bank_account_pk": 13402218,
                        "begin_date": "08/10/2020",
                        "end_date": "09/09/2020",
                        "begin_balance": "23614.24",
                        "end_balance": "20985.02",
                        "primary_recon_error_reason": null,
                        "secondary_recon_error_reason": null,
                        "uploaded_doc_pk": 52386256
                    }
                ],
                "account_holders": [
                    "JILL SMITH"
                ],
                "estimated_expense_by_month": {
                    "08/2020": "1871.17",
                    "09/2020": "65.13"
                },
                "daily_cash_flows": {
                    "08/10/2020": "450.00",
                    "08/11/2020": "0",
                    "08/12/2020": "550.65",
                    "08/13/2020": "-1145.47",
                    "08/14/2020": "0",
                    "08/15/2020": "322.86",
                    "08/16/2020": "893.44",
                    "08/17/2020": "443.86",
                    "08/18/2020": "0",
                    "08/19/2020": "-4000.00",
                    "08/20/2020": "0",
                    "08/21/2020": "-10.75",
                    "08/22/2020": "0",
                    "08/23/2020": "-54.25",
                    "08/24/2020": "0",
                    "08/25/2020": "0",
                    "08/26/2020": "0",
                    "08/27/2020": "0",
                    "08/28/2020": "-12.42",
                    "08/29/2020": "0",
                    "08/30/2020": "0",
                    "08/31/2020": "0",
                    "09/01/2020": "0",
                    "09/02/2020": "0",
                    "09/03/2020": "0",
                    "09/04/2020": "29.00",
                    "09/05/2020": "0",
                    "09/06/2020": "0",
                    "09/07/2020": "-33.00",
                    "09/08/2020": "-63.14",
                    "09/09/2020": "0"
                },
                "minimum_balance_by_month": {
                    "08/2020": "21052.16",
                    "09/2020": "20985.02"
                },
                "average_by_month": {
                    "08/2020": "612.02",
                    "09/2020": "31.28"
                },
                "deposit_max_by_month": {
                    "08/2020": [
                        {
                            "page_idx": 1,
                            "bank_account_pk": 13402218,
                            "amount": "893.44",
                            "bbox": [
                                142,
                                788,
                                2200,
                                829
                            ],
                            "txn_date": "08/16/2020",
                            "page_doc_pk": 314888745,
                            "pk": 3707780620,
                            "uploaded_doc_pk": 52386256,
                            "description": "Venmo Cashout PPD ID: 3592118565"
                        }
                    ],
                    "09/2020": [
                        {
                            "page_idx": 1,
                            "bank_account_pk": 13402218,
                            "amount": "29.00",
                            "bbox": [
                                142,
                                1371,
                                2204,
                                1413
                            ],
                            "txn_date": "09/04/2020",
                            "page_doc_pk": 314888745,
                            "pk": 3707780613,
                            "uploaded_doc_pk": 52386256,
                            "description": "Online Banking transfer from CHK 2580 Confimation # 2415004514"
                        }
                    ]
                },
                "outside_source_deposits": [
                    {
                        "page_idx": 0,
                        "bank_account_pk": 13402218,
                        "amount": "450.00",
                        "bbox": [
                            142,
                            2808,
                            2200,
                            2846
                        ],
                        "txn_date": "08/10/2020",
                        "page_doc_pk": 314888744,
                        "pk": 3707780609,
                        "uploaded_doc_pk": 52386256,
                        "description": "CHASE ATM 08/10 # 000002667 DEPOSIT 1608 AVE M BROOKLYN NY"
                    },
                    {
                        "page_idx": 0,
                        "bank_account_pk": 13402218,
                        "amount": "275.65",
                        "bbox": [
                            142,
                            2975,
                            2200,
                            3017
                        ],
                        "txn_date": "08/12/2020",
                        "page_doc_pk": 314888744,
                        "pk": 3707780607,
                        "uploaded_doc_pk": 52386256,
                        "description": "Square Inc DES * Cash App ID: T210623548125 INDN: Jill Smith CO [... ]"
                    },
                    {
                        "page_idx": 0,
                        "bank_account_pk": 13402218,
                        "amount": "600.00",
                        "bbox": [
                            142,
                            2892,
                            2200,
                            2929
                        ],
                        "txn_date": "08/12/2020",
                        "page_doc_pk": 314888744,
                        "pk": 3707780608,
                        "uploaded_doc_pk": 52386256,
                        "description": "CHASE ATM 08/12 # 000002686 DEPOSIT 1608 AVE M BROOKLYN NY"
                    },
                    {
                        "page_idx": 0,
                        "bank_account_pk": 13402218,
                        "amount": "90.00",
                        "bbox": [
                            142,
                            3142,
                            2200,
                            3183
                        ],
                        "txn_date": "08/13/2020",
                        "page_doc_pk": 314888744,
                        "pk": 3707780605,
                        "uploaded_doc_pk": 52386256,
                        "description": "Online Banking transfer from CHK 2580 Confimation # 2351315828"
                    },
                    {
                        "page_idx": 0,
                        "bank_account_pk": 13402218,
                        "amount": "550.00",
                        "bbox": [
                            142,
                            3308,
                            2200,
                            3350
                        ],
                        "txn_date": "08/15/2020",
                        "page_doc_pk": 314888744,
                        "pk": 3707780603,
                        "uploaded_doc_pk": 52386256,
                        "description": "CHASE ATM 08/15 # 000002687 DEPOSIT 1608 AVE M BROOKLYN NY"
                    },
                    {
                        "page_idx": 1,
                        "bank_account_pk": 13402218,
                        "amount": "893.44",
                        "bbox": [
                            142,
                            788,
                            2200,
                            829
                        ],
                        "txn_date": "08/16/2020",
                        "page_doc_pk": 314888745,
                        "pk": 3707780620,
                        "uploaded_doc_pk": 52386256,
                        "description": "Venmo Cashout PPD ID: 3592118565"
                    },
                    {
                        "page_idx": 1,
                        "bank_account_pk": 13402218,
                        "amount": "450.00",
                        "bbox": [
                            138,
                            871,
                            2204,
                            913
                        ],
                        "txn_date": "08/17/2020",
                        "page_doc_pk": 314888745,
                        "pk": 3707780619,
                        "uploaded_doc_pk": 52386256,
                        "description": "CHASE ATM 08/17 # 000002717 DEPOSIT 1608 AVE M BROOKLYN NY"
                    },
                    {
                        "page_idx": 1,
                        "bank_account_pk": 13402218,
                        "amount": "29.00",
                        "bbox": [
                            142,
                            1371,
                            2204,
                            1413
                        ],
                        "txn_date": "09/04/2020",
                        "page_doc_pk": 314888745,
                        "pk": 3707780613,
                        "uploaded_doc_pk": 52386256,
                        "description": "Online Banking transfer from CHK 2580 Confimation # 2415004514"
                    }
                ],
                "withdrawal_count": 11,
                "withdrawals_sum_by_month": {
                    "08/2020": "5871.17",
                    "09/2020": "96.14"
                },
                "average_daily_balance": "21995.67",
                "insurance_debits": [],
                "daily_balances": {
                    "08/10/2020": "24064.24",
                    "08/11/2020": "24064.24",
                    "08/12/2020": "24614.89",
                    "08/13/2020": "23469.42",
                    "08/14/2020": "23469.42",
                    "08/15/2020": "23792.28",
                    "08/16/2020": "24685.72",
                    "08/17/2020": "25129.58",
                    "08/18/2020": "25129.58",
                    "08/19/2020": "21129.58",
                    "08/20/2020": "21129.58",
                    "08/21/2020": "21118.83",
                    "08/22/2020": "21118.83",
                    "08/23/2020": "21064.58",
                    "08/24/2020": "21064.58",
                    "08/25/2020": "21064.58",
                    "08/26/2020": "21064.58",
                    "08/27/2020": "21064.58",
                    "08/28/2020": "21052.16",
                    "08/29/2020": "21052.16",
                    "08/30/2020": "21052.16",
                    "08/31/2020": "21052.16",
                    "09/01/2020": "21052.16",
                    "09/02/2020": "21052.16",
                    "09/03/2020": "21052.16",
                    "09/04/2020": "21081.16",
                    "09/05/2020": "21081.16",
                    "09/06/2020": "21081.16",
                    "09/07/2020": "21048.16",
                    "09/08/2020": "20985.02",
                    "09/09/2020": "20985.02"
                },
                "deposit_count": 8,
                "ppp_loan_txns": [],
                "average_daily_balance_by_month": {
                    "08/2020": "22383.99",
                    "09/2020": "21046.46"
                },
                "interbank_transactions": [],
                "total_days": 31,
                "round_number_txns": [
                    {
                        "page_idx": 1,
                        "bank_account_pk": 13402218,
                        "amount": "-4000.00",
                        "bbox": [
                            142,
                            1038,
                            2200,
                            1079
                        ],
                        "txn_date": "08/19/2020",
                        "page_doc_pk": 314888745,
                        "pk": 3707780617,
                        "uploaded_doc_pk": 52386256,
                        "description": "Online Banking Transfer to CHK 8759 Confirmation # 2454385332"
                    }
                ],
                "withdrawals_max_by_month": {
                    "08/2020": [
                        {
                            "page_idx": 1,
                            "bank_account_pk": 13402218,
                            "amount": "-4000.00",
                            "bbox": [
                                142,
                                1038,
                                2200,
                                1079
                            ],
                            "txn_date": "08/19/2020",
                            "page_doc_pk": 314888745,
                            "pk": 3707780617,
                            "uploaded_doc_pk": 52386256,
                            "description": "Online Banking Transfer to CHK 8759 Confirmation # 2454385332"
                        }
                    ],
                    "09/2020": [
                        {
                            "page_idx": 1,
                            "bank_account_pk": 13402218,
                            "amount": "-63.14",
                            "bbox": [
                                142,
                                1621,
                                2208,
                                1658
                            ],
                            "txn_date": "09/08/2020",
                            "page_doc_pk": 314888745,
                            "pk": 3707780610,
                            "uploaded_doc_pk": 52386256,
                            "description": "CHECKCARD 0623 2 FRIENDS DELI & GROCER BROOKLYN NY [... ]"
                        }
                    ]
                },
                "estimated_revenue_by_month": {
                    "08/2020": "3219.09",
                    "09/2020": "0.00"
                },
                "deposit_min_by_month": {
                    "08/2020": [
                        {
                            "page_idx": 0,
                            "bank_account_pk": 13402218,
                            "amount": "90.00",
                            "bbox": [
                                142,
                                3142,
                                2200,
                                3183
                            ],
                            "txn_date": "08/13/2020",
                            "page_doc_pk": 314888744,
                            "pk": 3707780605,
                            "uploaded_doc_pk": 52386256,
                            "description": "Online Banking transfer from CHK 2580 Confimation # 2351315828"
                        }
                    ],
                    "09/2020": [
                        {
                            "page_idx": 1,
                            "bank_account_pk": 13402218,
                            "amount": "29.00",
                            "bbox": [
                                142,
                                1371,
                                2204,
                                1413
                            ],
                            "txn_date": "09/04/2020",
                            "page_doc_pk": 314888745,
                            "pk": 3707780613,
                            "uploaded_doc_pk": 52386256,
                            "description": "Online Banking transfer from CHK 2580 Confimation # 2415004514"
                        }
                    ]
                },
                "insurance_credits": [],
                "average_deposit_by_month": {
                    "08/2020": "472.73",
                    "09/2020": "29.00"
                },
                "deposits_sum_by_month": {
                    "08/2020": "3309.09",
                    "09/2020": "29.00"
                },
                "alternative_lender_transactions": [],
                "txn_count": 19,
                "mca_payments_by_month": {
                    "08/2020": "0.00",
                    "09/2020": "0.00"
                },
                "deposit_sum": "3338.09",
                "alt_lender_payments_by_month": {
                    "08/2020": "0.00",
                    "09/2020": "0.00"
                },
                "period_balance_mismatches": [],
                "nsf_transactions": [],
                "deposits_count_by_month": {
                    "08/2020": 7,
                    "09/2020": 1
                },
                "negative_balances_by_month": {
                    "08/2020": [],
                    "09/2020": []
                },
                "withdrawal_sum": "-5967.31"
            }
        ],
        "book_uuid": "19aab921-25a5-4beb-a59e-ac72320061d6"
    },
    "message": "OK"
}

📘

Is it ready yet?

If you are having trouble downloading analytics data, please make sure you have allowed sufficient time for Ocrolus to analyze your document. Document analysis generally takes a few minutes, although factors such as document quality, source, and suspected fraud or suspicious activity can cause analysis to take longer.

Detect

Check if any sign of suspected fraud is detected on the uploaded documents. Detect will process only bank statements, pay stubs, and W-2s. It will run as the last step during the document processing phase.

📘

Note:

Ensure that you have configured webhooks to react on Ocrolus events. To know more about how to configure webhooks, see Configure webhooks.

Download detect-processes bank statement data

After Detect processes the document, you can check the results using API or Ocrolus Dashboard. You can check the results and get visualizations at the Book or document level using the following set of endpoints:

To get the Detect outcomes at the Book level:

  1. Send a GET request using Book Level Signals endpoint.
  2. Include your authentication header.
  3. Include the Book UUID value in the body of your request.

Example request

curl --location 'https://api.ocrolus.com/v2/detect/book/19aab921-25a5-4beb-a59e-ac72320061d6/signals' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6ImVDRnR4MXFtcGprYzdzT2FDUUZiVCJ9.eyJodHRwczovL2NsYWltcy5vY3JvbHVzLmNvbS9hY2NvdW50X3BrIjoiMTg5NzYiLCJodHRwczovL2NsYWltcy5vY3JvbHVzLmNvbS9vcmdfaW5mb19wayI6IjQwMDUiLCJodHRwczovL2NsYWltcy5vY3JvbHVzLmNvbS9lbWFpbCI6ImtzaW5naDErZGVtb0BvY3JvbHVzLmNvbSIsImlzcyI6Imh0dHBzOi8vYXV0aC5vY3JvbHVzLmNvbS8iLCJzdWIiOiI5aHppYTRJUDRxYTlQTGFzT25BYUw2ZzNVM014b3JPOEBjbGllbnRzIiwiYXVkIjoiaHR0cHM6Ly9hcGkub2Nyb2x1cy5jb20vIiwiaWF0IjoxNjc3ODE3OTcxLCJleHAiOjE2Nzc5MDQzNzEsImF6cCI6IjloemlhNElQNHFhOVBMYXNPbkFhTDZnM1UzTXhvck84IiwiZ3R5IjoiY2xpZW50LWNyZWRlbnRpYWxzIn0.eH8l6z0F8W5BPCEG0yVz919lYgQ_c9GUMheR096-UTcQCaxorjNjq567vY-f95yKdajBvsa_1SX6VB48bBA9MUDjGZwRY2oqfyuza2ola1CHb0ktn2Y2VEEukjgvvtR4AftaRnlSGzmWxA6MfZM-NdUVXfCtR8JpnqsK48PfclwvFX3r9FqOQkFmO5xmrbGcz2z0Dbkl6quKziiAM4d-mFt6_iJKQgmlQGE9R1FZGOkQ8kRzE2TjY9WFvoRzHamKqOnE6aa5sEb9ABl-MVZl-txSYlsFmyM6q9UXSvuzBUhyJStpW0L3Nhc9_qYSB-wNB--Sejb1E_fBcG7hDvPFUQ'
  1. A successful response will return the detected outcomes.

Example 200 response

{
    "book_uuid": "19aab921-25a5-4beb-a59e-ac72320061d6",
    "doc_analysis": [
        {
            "uploaded_doc_uuid": "4ad17d9e-1963-44c3-b709-2c5c80b9d667",
            "uploaded_doc_type": "BANK_STATEMENT",
            "detect_status": "COMPLETED",
            "form_analysis": [
                {
                    "form_type": "BANK_STATEMENT",
                    "form_uuid": "4ad17d9e-1963-44c3-b709-2c5c80b9d667",
                    "signals": [
                        {
                            "identifier": "account_type_edits",
                            "display_name": "Account Type Edits",
                            "signal_count": 1,
                            "page_number": 1,
                            "supporting_data": [
                                {
                                    "values": [
                                        {
                                            "key": "field_name",
                                            "value": "accountInfo:accountType",
                                            "data_type": "str"
                                        },
                                        {
                                            "key": "tampered_text",
                                            "value": "SUMMARY",
                                            "data_type": "str"
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "visualizations": [
                        {
                            "page_number": 1,
                            "page_visualizations": [
                                {
                                    "visual_type": "tamper_overview",
                                    "display_name": "Tamper Overview",
                                    "description": "Tampered fields are highlighted in red.",
                                    "image_url": "https://api.ocrolus.com/v2/detect/visualization/3722a2a1-fdd9-4fc1-9681-f38fdc98ce5b"
                                },
                                {
                                    "visual_type": "added_fonts",
                                    "display_name": "Added Fonts",
                                    "description": "Text that was added to the document is highlighted in red.",
                                    "image_url": "https://api.ocrolus.com/v2/detect/visualization/644cc4ac-404c-42a2-a8ef-6d5f437faf46"
                                }
                            ]
                        },
                        {
                            "page_number": 2,
                            "page_visualizations": [
                                {
                                    "visual_type": "tamper_overview",
                                    "display_name": "Tamper Overview",
                                    "description": "Tampered fields are highlighted in red.",
                                    "image_url": "https://api.ocrolus.com/v2/detect/visualization/8d4054ab-dec3-4e22-811a-ae208b984f34"
                                }
                            ]
                        },
                        {
                            "page_number": 3,
                            "page_visualizations": [
                                {
                                    "visual_type": "tamper_overview",
                                    "display_name": "Tamper Overview",
                                    "description": "Tampered fields are highlighted in red.",
                                    "image_url": "https://api.ocrolus.com/v2/detect/visualization/5ccf2524-1d10-41fb-b02f-2e58875edce7"
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

For further details, see Getting signals at the document level and Getting individual visualizations topics.