API Explorer 936 endpoints

Get Account Directory at Bank

GET /obp/v7.0.0/banks/BANK_ID/account-directory

OBPv6.0.0-getAccountDirectory Roles: CanGetAccountDirectoryAtOneBank(per bank) Account

Returns a list of accounts at the bank with identifiers and metadata.

This endpoint is designed for management UIs that need to list accounts without exposing sensitive data (balance and owners are excluded).

The response includes: account_id, bank_id, label, account_number, account_type, branch_id, account_routings, account_attributes and view_ids.

Possible custom url parameters for pagination:

  • limit=NUMBER ==> default value: 50
  • offset=NUMBER ==> default value: 0

eg1:?limit=100&offset=0

URL encoding: query parameter values containing &, =, +, #, %, or spaces must be URL-encoded (e.g. + → %2B, space → %20). Most other characters (including @ in emails) are safe unencoded, but encoding is always permitted.

  • sort_direction=ASC/DESC ==> default value: DESC.

eg2:?limit=100&offset=0&sort_direction=ASC

Authentication is Required

User Authentication is Required. The User must be logged in. The Application must also be authenticated.

URL Parameters:

BANK_ID: gh.29.uk

JSON response body fields (15)
account_attributes
account_id
8ca8a7e4-6d02-40e3-a129-0b2bf89de9f0
account_number
546387432
account_routings
account_type
AC
accounts
address
bank_id
gh.29.uk
branch_id
DERBY6
code
125
label
My Account
scheme
OBP
type
value
5987953
view_ids
view_ids
Example success response
{
  "accounts": [
    {
      "account_id": "8ca8a7e4-6d02-40e3-a129-0b2bf89de9f0",
      "bank_id": "gh.29.uk",
      "label": "My Account",
      "account_number": "123456789",
      "account_type": "CURRENT",
      "branch_id": "BRANCH_1",
      "account_routings": [
        {
          "scheme": "OBP",
          "address": "8ca8a7e4-6d02-40e3-a129-0b2bf89de9f0"
        }
      ],
      "account_attributes": [
        {
          "type": "STRING",
          "code": "OVERDRAFT_LIMIT",
          "value": "1000"
        }
      ],
      "view_ids": [
        "owner"
      ]
    }
  ]
}
Possible errors (4)
  • OBP-30001: Bank not found. Please specify a valid value for BANK_ID.
  • OBP-50000: Unknown Error.
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-20006: User is missing one or more roles:
Implemented by OBPv6.0.0 getAccountDirectory Originally /obp/v6.0.0/banks/BANK_ID/account-directory