Saltar al contenido principal
GET

Listado de movimientos de una cuenta bancaria

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

Listado de movimientos de una cuenta bancaria

Parámetros

Parámetros de ruta

idstringobligatorio

Identificador de la cuenta de tesorería

Parámetros de consulta

cursorstringopcional

Cursor opaco devuelto por la página anterior

limitintegeropcional= 50

Número máximo de movimientos por página. Por defecto 50, máximo 200

start_datestring<date>opcional

Límite inferior inclusivo de la fecha valor del movimiento (ISO 8601)

end_datestring<date>opcional

Límite superior inclusivo de la fecha valor del movimiento (ISO 8601)

statusstring[]opcional

Lista separada por comas de estados de conciliación a filtrar: 'pending', 'reconciled', 'partial', 'forced_reconciled'

Petición

python
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

json
{
  "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/json
object
items[]object[]
idstring

Unique identifier of the bank movement

banking_account_idstring

Identifier of the banking account this movement belongs to

descriptionstring

Description of the movement as reported by the bank

notestring

Manual annotation added by the user

amountstring

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).

currencystring

ISO 4217 currency code of the banking account

balancestring | null

Bank balance after the movement, in the banking account currency. Null if the bank did not report a balance

accounting_amountstring | null

Movement amount converted to the company accounting currency. Null when the movement has no accounting money assigned (e.g. unreconciled foreign-currency entries).

accounting_currencystring | null

ISO 4217 currency code of the company accounting currency. Null when the movement has no accounting money assigned.

booking_datestring<date-time>

Booking date — when the bank recorded the movement. ISO 8601 timestamp

value_datestring<date-time>

Value date as ISO 8601 timestamp

statusstring

Reconciliation status: 'pending' for not yet reconciled, 'reconciled' for fully matched against documents, 'partial' for partially matched, 'forced_reconciled' when manually marked as reconciled.

Enum:pendingreconciledpartialforced_reconciled
reconciled_amountstring

Amount of the movement already reconciled against documents/transactions, in the banking account currency

originstring

Source of the movement (e.g. stripe, paypal, manual, holded).

flagged_atstring<date-time> | null

ISO 8601 timestamp when the user manually flagged the movement. Null when not flagged.

cursorstring | null
has_moreboolean

Respuestas de error

401API key inválida o no proporcionadaapplication/json
403Permisos insuficientesapplication/json
404Cuenta bancaria no encontradaapplication/json
429Límite de solicitudes excedidoapplication/json