Llistat de remeses
accounting:remittances.readhttps://api.holded.com/api/v2/treasury/remittancesRetorna una llista paginada de remeses del teu compte. Els resultats utilitzen paginació per cursor (camps `cursor` i `has_more`); la mida per defecte és 25 i es pot ampliar fins a 100 amb `limit`. Els resultats es poden filtrar combinant: direcció (`type`, inbound o outbound), estat de processament (`status`: pending, completed, processing), interval de dates (`start_date` / `end_date`), compte bancari de tresoreria (`bank_id`), creditor (`creditor_swift`, `creditor_iban`, `creditor_id`) i emissor (`issuer_id`). Utilitza'l quan l'usuari demani llistar, veure o filtrar les seves remeses — p. ex. "remeses pendents del darrer mes", "remeses de Caixa", "remeses per IBAN ES91…", "remeses de cobrament", "remeses de pagament a proveïdors". Aquest endpoint retorna lots de remeses; per a factures individuals utilitza el llistat de factures, i per a pagaments individuals no agrupats en una remesa utilitza el llistat de pagaments.
Paràmetres
Paràmetres de consulta
stringopcionalFiltrar per direcció de la remesa. `inbound` per a remeses de cobrament rebudes de clients (remeses de cobrament, adeudos SEPA, rebuts domiciliats). `outbound` per a remeses de pagament emeses a proveïdors (remeses de pagament, transferències SEPA a proveïdors, pagaments a proveïdors).
"inbound""outbound"stringopcionalFiltrar per estat de processament
"pending""completed""processing"string<date>opcionalLímit inferior inclusiu de la data de la remesa (format ISO 8601, p. ex. 2026-01-01)
string<date>opcionalLímit superior inclusiu de la data de la remesa (format ISO 8601, p. ex. 2026-12-31)
stringopcionalFiltrar per identificador de compte bancari de la tresoreria
stringopcionalFiltrar per codi SWIFT/BIC del banc creditor (8 o 11 caràcters alfanumèrics)
stringopcionalFiltrar per IBAN del creditor
stringopcionalFiltrar per identificador del creditor SEPA
stringopcionalFiltrar per identificador de l'emissor
stringopcionalCursor opac per a la paginació
integeropcional= 50Nombre màxim de remeses a retornar per pàgina. Per defecte 25, màxim 100
Petició
import requests
url = "https://api.holded.com/api/v2/treasury/remittances?type=value&status=value&start_date=2026-01-01"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
response = requests.get(url, headers=headers)
print(response.json())Respostes
Resposta
{
"items": [
{
"id": "string",
"type": "inbound",
"treasury_id": "string",
"description": "string",
"date": "2024-01-15",
"mode": "core",
"iban": "string",
"swift": "string",
"creditor_id": "string",
"issuer_id": "string",
"total": "1234.56",
"status": "pending"
}
],
"cursor": "string",
"has_more": false
}Respostes exitoses
200Llistat de remesesapplication/jsonUnique identifier of the remittance
Direction of the remittance
inboundoutboundIdentifier of the treasury account used
Free-text description of the remittance
Remittance date in ISO 8601 format
SEPA direct debit scheme used for the remittance
corecor1b2bcoredtoIBAN of the creditor bank account
SWIFT/BIC code of the creditor bank
SEPA creditor identifier
Issuer identifier for the remittance
Total amount of the remittance as a decimal string
Current processing status of the remittance
pendingcompletedprocessingRespostes d'error
400Paràmetre de filtre no vàlidapplication/json401API key no vàlida o no proporcionadaapplication/json403Permisos insuficientsapplication/json429Límit de sol·licituds exceditapplication/json