Listing bank accounts

GET /api/public/v1/bank_accounts

This endpoint returns a list of bank accounts linked to your Txn account.

Please note that Txn clients cannot add beneficiaries themselves just yet. Instead, please reach out to your account manager.

Headers

Name	Value
Content-Type	application/vnd.api+json
Authorization	Bearer <api_key>

Response Body

Name	Type	Description
data[].id	string	Bank account ID.
data[].type	string	Entity type returned. Always bankAccounts.
data[].attributes	object	Set of bank account attributes.
data[].attributes.beneficiaryName	string	Name of the beneficiary on the bank account.
data[].attributes.iban	string	Beneficiary IBAN.
data[].attributes.bankName	string	Name of the beneficiary's bank.
data[].attributes.bankBic	string	BIC/SWIFT code of the beneficiary's bank.
data[].attributes.currencyCode	string	Account currency code. Refer to supported currencies.
data[].attributes.label	string	User-defined label for the bank account.
data[].attributes.createdAt	string	Timestamp when the bank account was created. Refer to the Date and time format page.
data[].attributes.updatedAt	string	Timestamp when the bank account was last updated.
meta.page	number	Current page number.
meta.per_page	number	Page size used for the response.
meta.total	number	Total number of bank accounts available.

Response

HTTP 200

{
  "data": [
    {
      "id": "a754cd82-74a0-4c1c-a832-e83445bce2c5",
      "type": "bank_accounts",
      "attributes": {
        "beneficiaryName": "Acme Limited",
        "currencyCode": "EUR",
        "iban": "LT563400023810000822",
        "createdAt": "2024-12-07T11:42:27.571Z",
        "updatedAt": "2024-12-07T11:42:27.571Z",
        "bankBic": "GXPTLT22XXX",
        "bankName": "BANK NAME"
      }
    },
    {
      "id": "f96d0db2-3e5d-42b4-8e36-7a0ea2a951fe",
      "type": "bank_accounts",
      "attributes": {
        "beneficiaryName": "Acme Limited",
        "currencyCode": "EUR",
        "iban": "LT293400023810000823",
        "createdAt": "2024-10-24T14:13:11.802Z",
        "updatedAt": "2024-12-07T11:21:01.250Z",
        "bankBic": "GXPTLT22XXX",
        "bankName": "BANK NAME"
      }
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 10,
    "total": 2
  },
  "jsonapi": {
    "version": "1.0"
  }
}