Upload a JSON file containing a Plaid Asset and Transaction data to a Book.



This is an Upload endpoint and hence requires a payload of Content-Type multipart/form-data. For details on how to encode request bodies in the platform of your choice, refer to our guide on multipart/form-data Payloads.

This endpoint can take the JSON output from either the /transactions/get or /asset_report/get endpoints from Plaid. Please see transactionsget and asset_reportget for Plaid's documentation on these endpoints.


Users have reported issues with accessing these endpoints from older versions of Plaid's Python and Ruby client libraries. If possible, use the latest versions available. We encourage you to open a ticket with Plaid if you believe you've discovered a bug. In the meantime, you can use an all-purpose HTTP request library as a workaround.

Plaid Asset Reports do not provide Statement Periods. Ocrolus must construct Statement Periods during document analysis. For each Account, Statement Periods are bound by the date of the earliest and latest Transaction in a given month.

If an Asset Report JSON file contains Transactions from Jan 15th, 2019 to April 4th, 2019, the Statement Periods are:

  • Jan 15th - Jan 31st.
  • Feb 1st - Feb 28th.
  • March 1st - March 31st.
  • April 1st - April 4th.


We recommend that you create a separate Book to process each Plaid Asset Report. Try to avoid uploading JSON files alongside PDF Statements. PDF Statements are not likely to reconcile with Plaid formatting.

Click Try It! to start a request and see the response here!