Retrieve Accounts V3

by Thomas Purton
Change typeDateProducts
New API 4th September 2024Enrich
Engage

✍️ Description

The release of Retrieve Accounts V3 and Retrieve Account by ID V3 provides three main improvements over the existing Accounts V2 endpoint;

  • Normalisation of balance types - Bud is now normalising the balance types that we receive upon ingestion into either booked or pending making it easier for you to know what should be displayed to your customers.
  • Normalisation of credit lines - Bud is normalising credit lines that we receive upon ingestion so that the limit displayed is always the total credit limit/overdraft amount of the account.
  • Consistent naming of holders object - Regardless of whether you're ingesting parties data or not the name of the holders object will be consistent.

🚧

Please note, with the release of Accounts V3, we have also added a deprecation notice of 1st April 2025 for Retrieve Accounts V2 and Retrieve Account By ID V2


📘 Guides

  • More information about the account response can be found in our updated Accounts Object guide.
  • We have also updated our guide on how to perform account verification to include using Accounts V3.
  • Various other guides have also been updated to reference Accounts V3 instead of Accounts V2.
  • Added Retrieve Accounts V3 endpoint.
  • Added Retrieve Accounts By ID V3 endpoint.
  • Add status field to Ingest Transactions V2 on application/bud-transaction-v3+json format.
  • Added Income Expenditure Report Insight Beta endpoint.
  • Added Income Expenditure Report Insight Transactions Beta endpoint.
  • Added Income Health Insight Report Beta endpoint.
  • Added Income Health Report Insight Transactions Beta endpoint.
  • Added Unauthorised Overdraft Insight Report Beta endpoint.
  • Added Unauthorised Overdraft Insight Report Transactions Beta endpoint.
  • Added Merchant Report Insight Beta endpoint.
  • Added Merchant Report Insight Transactions Beta endpoint.
  • Added new Correction Merchant Search endpoint under Correct Financial Data.
  • Added new Correct Transaction Merchant endpoint under Correct Financial Data.
  • Added website field to merchant field in enrichments field in Retrieve Transactions V2.
  • Added website field to processor field in enrichments field in Retrieve Transactions V2.
  • Added a new Correct Financial Data section within FINANCIAL DATA API.
  • Relocated Correct Transaction Categories V2 endpoint to Correct Financial Data from Manage Financial Data.
  • Added new Similar Transactions endpoint under Correct Financial Data.
  • Added new Similar Transactions Including Merchants endpoint under Correct Financial Data.
  • Added Initiate Refresh V2 endpoint.
  • Added Retrieve Refresh Status V2 endpoint.
  • Deprecated Initiate Refresh endpoint in favour of Initiate Refresh V2 endpoint (Six month deprecation period).
  • Deprecated Retrieve Refresh Status endpoint in favour of Retrieve Refresh Status V2 endpoint (Six month deprecation period).