Listado de movimientos de una cuenta bancaria
accounting:banks.readhttps://api.holded.com/api/v2/treasury/accounts/{id}/bank-movementsListado de movimientos de una cuenta bancaria
Parámetros
Parámetros de ruta
stringobligatorioIdentificador de la cuenta de tesorería
Parámetros de consulta
stringopcionalCursor opaco devuelto por la página anterior
integeropcional= 50Número máximo de movimientos por página. Por defecto 50, máximo 200
string<date>opcionalLímite inferior inclusivo de la fecha valor del movimiento (ISO 8601)
string<date>opcionalLímite superior inclusivo de la fecha valor del movimiento (ISO 8601)
string[]opcionalLista separada por comas de estados de conciliación a filtrar: 'pending', 'reconciled', 'partial', 'forced_reconciled'
Petición
import requests
url = "https://api.holded.com/api/v2/treasury/accounts/507f1f77bcf86cd799439011/bank-movements?cursor=value&limit=50&start_date=2026-01-01"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
response = requests.get(url, headers=headers)
print(response.json())Respuestas
Respuesta
{
"items": [
{
"id": "507f1f77bcf86cd799439011",
"banking_account_id": "507f1f77bcf86cd799439012",
"description": "string",
"note": "string",
"amount": "1500.00",
"currency": "EUR",
"balance": "12345.67",
"accounting_amount": "1500.00",
"accounting_currency": "EUR",
"booking_date": "2024-01-15T10:30:00Z",
"value_date": "2024-01-15T10:30:00Z",
"status": "reconciled",
"reconciled_amount": "1500.00",
"origin": "manual",
"flagged_at": "2024-01-15T10:30:00Z"
}
],
"cursor": "string",
"has_more": false
}Respuestas exitosas
200Listado de movimientos bancariosapplication/jsonUnique identifier of the bank movement
Identifier of the banking account this movement belongs to
Description of the movement as reported by the bank
Manual annotation added by the user
Movement amount in the banking account currency. Decimal as string; precision matches the currency (e.g. 2 decimals for EUR/USD, 3 for BHD/KWD).
ISO 4217 currency code of the banking account
Bank balance after the movement, in the banking account currency. Null if the bank did not report a balance
Movement amount converted to the company accounting currency. Null when the movement has no accounting money assigned (e.g. unreconciled foreign-currency entries).
ISO 4217 currency code of the company accounting currency. Null when the movement has no accounting money assigned.
Booking date — when the bank recorded the movement. ISO 8601 timestamp
Value date as ISO 8601 timestamp
Reconciliation status: 'pending' for not yet reconciled, 'reconciled' for fully matched against documents, 'partial' for partially matched, 'forced_reconciled' when manually marked as reconciled.
pendingreconciledpartialforced_reconciledAmount of the movement already reconciled against documents/transactions, in the banking account currency
Source of the movement (e.g. stripe, paypal, manual, holded).
ISO 8601 timestamp when the user manually flagged the movement. Null when not flagged.
Respuestas de error
401API key inválida o no proporcionadaapplication/json403Permisos insuficientesapplication/json404Cuenta bancaria no encontradaapplication/json429Límite de solicitudes excedidoapplication/json