Saltar al contingut principal
GET

Obtenir un compte bancari per ID

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

Recupera tots els detalls d'un compte bancari específic pel seu identificador únic.

Paràmetres

Paràmetres de ruta

idstringobligatori

Identificador del compte de tresoreria

Petició

python
import requests

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

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

Respostes

Resposta

json
{
  "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
}

Respostes exitoses

200Compte bancari trobatapplication/json
object
idstring

Unique identifier of the banking account

namestring

Display name of the banking account

typestring

Type of banking account

Enum:bankcardgatewaycash
currencystring

ISO 4217 currency code of the account

balancestring

Decimal as string for precision

ibanstring | null

IBAN number of the bank account

bicstring | null

SWIFT/BIC code of the bank

account_numberstring | null

Bank account number when IBAN is not available

creditor_idstring | null

SEPA creditor identifier for direct debits

issuer_idstring | null

Issuer identifier used in remittances

archivedboolean

Whether the banking account is archived

synced_atstring<date-time> | null

Timestamp of the last bank synchronization

transactions_pending_to_reconcileinteger

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

Respostes d'error

401API key no vàlida o no proporcionadaapplication/json
403Permisos insuficientsapplication/json
404Compte bancari no trobatapplication/json
429Límit de sol·licituds exceditapplication/json