Skip to main content

Completed 2023-07-10: Deprecation of the use of bankAccounts and bankTransactions data types for banking data connections

· 2 min read
Grace Shiach
Grace Shiach
Product Manager, Integrations

On July 10, 2023, Codat will deprecate the use of bankAccounts and bankTransactions data types for syncing banking data connectionsConnection A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform. via Plaid, TrueLayer and Basiq. The use of these data types for accounting data connectionsConnection A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform. will remain unchanged.

Requests made to the following endpoints for banking data connectionsConnection A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform. will no longer trigger a syncSync The process of fetching the latest data from a connected data source. Syncs can be triggered manually or run automatically on a schedule.:

  • POST /companies/{companyId}/data/queue/bankAccounts
  • POST /companies/{companyId}/data/queue/bankTransactions

After the change is implemented, a call to either of these endpoints for a Plaid, TrueLayer, or Basiq data connectionConnection A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform. ID will return a 400 response.

Action required​​

If you haven't already done so, switch to using the banking data types: banking-accounts and banking-transactions. Enable these in your settings in the Portal.

You will also need to update any parts of your code that expect the response body from the banking-accounts and banking-transactions endpoints. For examples of the new response bodies for these data types, refer to the APIAPI A set of rules and protocols that allows different software applications to communicate with each other. Codat provides APIs for accessing financial data from accounting, banking, and commerce platforms. reference.

Expected impact if no action is taken​​

After July 10, 2023, calls made using bankAccounts and bankTransactions data types for a Plaid, TrueLayer or Basiq data connectionConnection A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform. ID will return a 400 error:

{
  "statusCode": 400,
  "service": "PullApi",
  "error": "Datatype 'bankAccounts' not supported by platform baecf6cb-402c-4611-ae02-b0b5f7e3384f",
  "correlationId": "1f0ab3dcd57fe1de9c93b0a138fa56e5",
  "canBeRetried": "Unknown",
  "detailedErrorCode": 0
}

Contents

Suggest edits