Saltar al contingut principal
GET

Llistat de remeses

Scope:accounting:remittances.read
https://api.holded.com/api/v2/treasury/remittances

Retorna 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

typestringopcional

Filtrar 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"
statusstringopcional

Filtrar per estat de processament

"pending""completed""processing"
start_datestring<date>opcional

Límit inferior inclusiu de la data de la remesa (format ISO 8601, p. ex. 2026-01-01)

end_datestring<date>opcional

Límit superior inclusiu de la data de la remesa (format ISO 8601, p. ex. 2026-12-31)

bank_idstringopcional

Filtrar per identificador de compte bancari de la tresoreria

creditor_swiftstringopcional

Filtrar per codi SWIFT/BIC del banc creditor (8 o 11 caràcters alfanumèrics)

creditor_ibanstringopcional

Filtrar per IBAN del creditor

creditor_idstringopcional

Filtrar per identificador del creditor SEPA

issuer_idstringopcional

Filtrar per identificador de l'emissor

cursorstringopcional

Cursor opac per a la paginació

limitintegeropcional= 50

Nombre màxim de remeses a retornar per pàgina. Per defecte 25, màxim 100

Petició

python
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

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

Unique identifier of the remittance

typestring

Direction of the remittance

Enum:inboundoutbound
treasury_idstring

Identifier of the treasury account used

descriptionstring | null

Free-text description of the remittance

datestring<date> | null

Remittance date in ISO 8601 format

modestring | null

SEPA direct debit scheme used for the remittance

Enum:corecor1b2bcoredto
ibanstring

IBAN of the creditor bank account

swiftstring | null

SWIFT/BIC code of the creditor bank

creditor_idstring | null

SEPA creditor identifier

issuer_idstring | null

Issuer identifier for the remittance

totalstring

Total amount of the remittance as a decimal string

statusstring

Current processing status of the remittance

Enum:pendingcompletedprocessing
cursorstring | null
has_moreboolean

Respostes d'error

400Paràmetre de filtre no vàlidapplication/json
401API key no vàlida o no proporcionadaapplication/json
403Permisos insuficientsapplication/json
429Límit de sol·licituds exceditapplication/json