Enriched transactions

This API provides categorizations for each transaction in the requested Book. It's the building block for all the Cash Flow Analytics products. It contains a comprehensive list of categories, accurate Transaction tagging, and improved revenue, expense, and transfer logic.


Async processing

This API supports asynchronous processing. To get the asynchronous result, add async=true in the query parameter to run the request as a background job and receive a job_id immediately instead of waiting for the full response inline. When async=true, the endpoint returns 202 Accepted with a job_id instead of the analytics payload.

Async mode is required for Books with more than 100,000 transactions. Books exceeding 1,000,000 transactions are rejected with 422 (error code 1100). Once submitted, poll
Async job status API to retrieve the result when the job is complete.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

The unique identifier of the Book that you'd like to analyze.

Query Params
integer

The starting point (number of records to skip) from the latest transaction to fetch results.

integer

The maximum number of records to be fetched starting from the specified offset value.

boolean
enum
Defaults to false

Provides an option to include pending transactions in the response. When set to true, the response payload includes an additional pending_plaid_transactions field listing currently pending transactions for the Book’s Plaid-linked accounts.

Pending Plaid transactions are transactions that the financial institution has reported to Plaid but which have not yet posted to the account. For example, card authorizations that have not cleared, or ACH debits still in flight. Including them gives you early visibility into recent activity that will eventually appear in the posted transaction set.

📘

Note

  • Pending transactions are surfaced for visibility only. They are not processed through Ocrolus’s enrichment pipeline and therefore do not include tags, categories, or counterparties.
  • These transactions are excluded from all analytics outputs. Cash flow features, Book summaries, risk scores, lender analytics, and analytics exports are computed only from posted transactions.
  • Once a pending transaction posts at the financial institution, it is processed through enrichment and appears in the standard posted transaction set on the next refresh. The pending entry is then removed.
Allowed:
boolean
Defaults to false

When true, runs the request as a background job and returns a job_id immediately instead of the analytics payload. Required for Books with more than 100,000 transactions. Books exceeding 1,000,000 transactions are rejected with 422 (error code 1100).

Responses

Language
Credentials
OAuth2
LoadingLoading…
Response
Choose an example:
application/json