Scope: accounting:banks.read https://api.alladdin.com/api/v2/treasury/accounts/{id}

Retrieves the full details of a single banking account by its unique identifier.
The response includes the current balance, bank details (IBAN, BIC), synchronization status, and archived state.

Parameters

Path parameters

id string required

Banking account identifier

Request

import requests

url = "https://api.alladdin.com/api/v2/treasury/accounts/{id}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())

Responses

Response

{
  "id": "507f1f77bcf86cd799439011",
  "name": "Main bank account",
  "type": "bank",
  "currency": "EUR",
  "balance": "15230.50",
  "iban": "ES9121000418450200051332",
  "bic": "CAIXESBBXXX",
  "account_number": "string",
  "creditor_id": "string",
  "issuer_id": "string",
  "archived": false,
  "synced_at": "2024-01-15T10:30:00Z",
  "transactions_pending_to_reconcile": 148
}

Success responses

200 Banking account found application/json object id string

Unique identifier of the banking account

name string

Display name of the banking account

type string

Type of banking account

Enum: bank card gateway cash currency string

ISO 4217 currency code of the account

balance string

Decimal as string for precision

iban string | null

IBAN number of the bank account

bic string | null

SWIFT/BIC code of the bank

account_number string | null

Bank account number when IBAN is not available

creditor_id string | null

SEPA creditor identifier for direct debits

issuer_id string | null

Issuer identifier used in remittances

archived boolean

Whether the banking account is archived

synced_at string<date-time> | null

Timestamp of the last bank synchronization

transactions_pending_to_reconcile integer

Number of transactions pending reconciliation in the last 12 months for this account (precomputed, not a live count).

Error responses

401 Invalid or missing API key application/json 403 Insufficient permissions application/json 404 Banking account not found application/json 429 Rate limit exceeded application/json

← PreviousCreate a banking account →

Next →Update a banking account →