> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# API de llistat de comptes bancaris: comptes d'una connexió

> L'endpoint List Accounts de Didit retorna tots els comptes que la persona ha compartit en una connexió, tant personals com d'empresa.

L'endpoint de llistat de comptes de Didit retorna tots els comptes que la persona ha compartit en una connexió, tant personals com empresarials.
Els identificadors dels comptes es mantenen iguals mentre la connexió existeixi, incloses les renovacions.


## OpenAPI

````yaml ca/openapi-25.json GET /v3/bank/connections/{id}/accounts/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API de verificació d'identitat. Autentica't amb la capçalera x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags:
  - name: Bank Data
    description: >-
      Bank Link, connexions, comptes, saldos, transaccions, entitats i
      cobertura. Les dades bancàries estan disponibles per a aplicacions en
      sandbox. Les crides d'una aplicació en producció responen `404` fins que
      s'anunciï l'accés en producció. No es cobra res en sandbox. Una crida feta
      amb una clau d'API necessita una clau que tingui el permís Bank data
      (`bank-data`): lectura per a les lectures, escriptura per a les operacions
      que canvien alguna cosa. La comprovació de comptes n'és l'excepció:
      necessita accés d'escriptura a sessions, o accés complet, i no el permís
      Bank data. Bank data no forma part de l'accés complet: una clau amb accés
      complet es rebutja, i la crida respon `403 bank_data_access_denied` fins
      que creïs una clau que tingui el permís. Les dades bancàries en brut
      (comptes, saldos, transaccions i el feed de canvis) també rebutgen una
      sol·licitud que no porti cap clau d'API.


      Cada rebuig sota `/v3/bank/` excepte el de la comprovació de comptes té el
      mateix cos JSON (`code`, `message`, `request_id`, `field`, `next_action`,
      `retry_after`). Un camí que no és una operació, un identificador que no és
      un UUID o un subrecurs desconegut respon `404 not_found` per a qualsevol
      mètode, i qualsevol error inesperat respon `500 internal_error` amb un
      `request_id`. Quan les dades bancàries no estan disponibles, cada operació
      respon el `404` estàndard de la plataforma, exactament com ho fa una ruta
      desconeguda.
paths:
  /v3/bank/connections/{id}/accounts/:
    get:
      tags:
        - Bank Data
      summary: Llista els comptes d'una connexió
      description: >-
        Llista cada compte de la connexió, del més antic al més nou, amb
        identificadors complets i titulars. Una lectura mai es factura.


        Necessita una clau d'API amb el permís Bank data (`bank-data`): lectura
        per a aquesta operació. Una clau amb accés complet no l'inclou:
        concedeix-lo explícitament en crear la clau, o la crida respon `403
        bank_data_access_denied`. Una aplicació sandbox llegeix les seves dades
        de Test Bank només amb la clau. Una sol·licitud sense clau d'API
        (credencials de client) es rebutja quan demana dades en brut, amb el
        mateix `403`.
      operationId: listBankAccounts
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: L'id de la connexió.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 100
            minimum: 1
            maximum: 500
          description: Mida de pàgina, de 1 a 500. Per defecte, 100.
        - name: cursor
          in: query
          required: false
          schema:
            type: string
          description: Cursor opac del `next_cursor` de la pàgina anterior.
      responses:
        '200':
          description: Una pàgina de comptes.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankAccountList'
              examples:
                Page:
                  summary: Dos comptes empresarials
                  value:
                    items:
                      - id: a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10
                        connection_id: 5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35
                        name: Cuenta negocio
                        product: Cuenta corriente empresas
                        type: current
                        usage: business
                        currency: EUR
                        holder_name: EMPRESA DE EJEMPLO SL
                        holders:
                          - name: EMPRESA DE EJEMPLO SL
                            role: holder
                        identifiers:
                          iban: ES0000000000000000001332
                          bic: XXXXESBBXXX
                          account_number: null
                          sort_code: null
                          other: []
                        account_ref: ar_f3c1a85e9d27b640c8e1
                        account_ref_previous: null
                        status: open
                        scopes_granted:
                          - accounts
                          - balances
                          - transactions
                        sync:
                          last_synced_at: '2026-11-21T12:04:40Z'
                          status: ok
                          history_requested_from: '2025-11-21'
                          history_available_from: '2026-01-02'
                          pending_supported: true
                        history_coverage:
                          requested_from: '2025-11-21'
                          oldest_booking_date: '2026-01-02'
                          covered_ranges:
                            - from: '2026-01-02'
                              to: '2026-11-21'
                          missing_ranges:
                            - from: '2025-11-21'
                              to: '2026-01-01'
                          status: partial
                          extended_auth_used: false
                    next_cursor: null
        '400':
          description: Un paràmetre no és vàlid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Invalid cursor:
                  summary: Cursor no vàlid
                  value:
                    code: invalid_cursor
                    message: The cursor or page token is not valid.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: cursor
                    next_action: null
                    retry_after: null
                Invalid request:
                  summary: Sol·licitud no vàlida
                  value:
                    code: invalid_request
                    message: The request is not valid.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: limit
                    next_action: null
                    retry_after: null
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/BankDataAccessDenied'
        '404':
          description: El recurs no existeix en aquesta aplicació ni en aquest entorn.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Not found:
                  summary: No trobat
                  value:
                    code: not_found
                    message: The resource does not exist.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: null
                    next_action: null
                    retry_after: null
        '409':
          description: >-
            La connexió no té dades llegibles: s'ha eliminat, o ha finalitzat el
            seu període de conservació (`connection_not_active`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Not active:
                  summary: No actiu
                  value:
                    code: connection_not_active
                    message: This connection is not active.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: null
                    next_action: create_link
                    retry_after: null
        '429':
          $ref: '#/components/responses/RateLimitedRead'
        '500':
          $ref: '#/components/responses/BankDataInternalError'
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl
            'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/accounts/'
            \
              -H 'x-api-key: YOUR_API_KEY'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY.
            client = Didit()

            result = client.bank.list_accounts(
                "11111111-2222-3333-4444-555555555555",
            )
            print(result)
        - lang: javascript
          label: Node.js
          source: >-
            import Didit from "@didit-protocol/sdk-node";


            // Reads DIDIT_API_KEY.

            const didit = new Didit();


            const result = await
            didit.bank.listAccounts("11111111-2222-3333-4444-555555555555");

            console.log(result);
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Bank.ListAccounts(ctx, \"11111111-2222-3333-4444-555555555555\", didit.BankListAccountsParams{})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"
        - lang: java
          label: Java
          source: >-
            import me.didit.Didit;


            // Reads DIDIT_API_KEY.

            Didit client = new Didit();


            var result =
            client.bank().listAccounts("11111111-2222-3333-4444-555555555555");

            System.out.println(result);
        - lang: php
          label: PHP
          source: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY.

            $didit = new DiditClient();


            $result =
            $didit->bank->listAccounts('11111111-2222-3333-4444-555555555555');

            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: >-
            require "didit"


            # Reads DIDIT_API_KEY.

            didit = Didit::Client.new


            result =
            didit.bank.list_accounts("11111111-2222-3333-4444-555555555555")

            puts result.to_h
        - lang: csharp
          label: .NET
          source: >-
            using System;

            using System.Text.Json;

            using Didit;


            // Reads DIDIT_API_KEY.

            using var client = new DiditClient();


            var result = await
            client.Bank.ListAccountsAsync("11111111-2222-3333-4444-555555555555");

            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  schemas:
    BankAccountList:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/BankAccount'
        next_cursor:
          type: string
          nullable: true
      required:
        - items
        - next_cursor
    BankDataError:
      type: object
      description: >-
        Cos de l'error de cada operació de dades bancàries. Tots els camps hi
        són sempre presents.
      properties:
        code:
          type: string
          enum:
            - ongoing_access_not_available
            - segment_not_available
            - window_not_available
            - history_window_ambiguous
            - redirect_url_not_registered
            - link_origin_not_allowed
            - bank_data_access_denied
            - connection_not_active
            - consent_expired
            - renewal_not_needed
            - renewal_window_expired
            - access_removed
            - refresh_limit_reached
            - cursor_expired
            - page_expired
            - invalid_cursor
            - page_token_mismatch
            - contract_rate_missing
            - insufficient_credits
            - invalid_request
            - not_found
            - internal_error
          description: >-
            Codi d'error llegible per màquina. Decideix a partir d'aquest codi,
            mai a partir de `message`.
        message:
          type: string
          description: >-
            Explicació en llenguatge senzill per a un desenvolupador. La
            redacció pot canviar; no l'analitzis.
        request_id:
          type: string
          description: >-
            Identificador d'aquesta sol·licitud. Indica'l quan contactis amb el
            suport.
        field:
          type: string
          description: >-
            El camp de la sol·licitud que cal corregir, quan l'error fa
            referència a un sol camp. Altrament, `null`.
          nullable: true
        next_action:
          type: string
          enum:
            - retry_later
            - renew_connection
            - create_link
            - restart_from_cursor
            - restart_read
            - top_up_balance
            - enable_bank_data_access
            - contact_support
            - null
          description: >-
            Què cal fer a continuació, perquè un client pugui actuar sense
            endevinar. `null` quan no hi ha un pas següent estàndard.
          nullable: true
        retry_after:
          type: integer
          description: >-
            Segons a esperar abans de reintentar. S'estableix en els errors de
            límit de freqüència i en els errors temporals; en cas contrari,
            `null`.
          nullable: true
      required:
        - code
        - message
        - request_id
        - field
        - next_action
        - retry_after
      example:
        code: ongoing_access_not_available
        message: >-
          This bank cannot keep access open. Use access one_time or choose
          another bank.
        request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
        field: institution_id
        next_action: create_link
        retry_after: null
    BankAccount:
      type: object
      description: Un compte dins d'una connexió.
      properties:
        id:
          type: string
          description: >-
            Identificador del compte. Pertany a la connexió i no canvia mentre
            existeixi, inclosos els renovaments.
          format: uuid
        connection_id:
          type: string
          format: uuid
        name:
          type: string
          nullable: true
        product:
          type: string
          description: El nom del producte del banc.
          nullable: true
        type:
          type: string
          enum:
            - current
            - savings
            - card
            - loan
            - investment
            - other
        usage:
          type: string
          enum:
            - personal
            - business
            - unknown
        currency:
          type: string
          pattern: ^[A-Z]{3}$
          description: Codi de moneda ISO 4217.
        holder_name:
          type: string
          description: Nom del titular quan el banc el comparteix.
          nullable: true
        holders:
          type: array
          items:
            $ref: '#/components/schemas/BankAccountHolder'
          description: >-
            Titulars que el banc comparteix. La titularitat només compta
            `holder` i `joint_holder`.
        identifiers:
          $ref: '#/components/schemas/BankAccountIdentifiers'
        account_ref:
          type: string
          description: >-
            Identifica el mateix compte bancari entre connexions d'una mateixa
            aplicació i entorn: un hash amb clau dels identificadors propis del
            banc. `null` quan el banc no facilita cap identificador fiable.
            Utilitza'l per reconèixer un compte bancari que ja coneixes.
          nullable: true
        account_ref_previous:
          type: string
          description: >-
            L'`account_ref` anterior, només per a un àlies verificat, com una
            migració de banc.
          nullable: true
        status:
          type: string
          enum:
            - open
            - closed
            - access_removed
          description: >-
            `access_removed`: la persona ha eliminat el compte del consentiment.
            Ja no es sincronitza.
        scopes_granted:
          type: array
          items:
            type: string
            enum:
              - accounts
              - balances
              - transactions
        sync:
          $ref: '#/components/schemas/BankAccountSync'
        history_coverage:
          $ref: '#/components/schemas/BankHistoryCoverage'
      required:
        - id
        - connection_id
        - name
        - product
        - type
        - usage
        - currency
        - holder_name
        - holders
        - identifiers
        - account_ref
        - account_ref_previous
        - status
        - scopes_granted
        - sync
        - history_coverage
    RateLimitBudgetError:
      type: object
      description: >-
        Només es retorna en un rebuig del pressupost del middleware de límit de
        freqüència. Altres errors 429, inclosos conflictes d'idempotència i
        límits específics de l'endpoint, no garanteixen aquests camps de
        metadades.
      required:
        - detail
        - reference
        - limit
        - remaining
        - reset
        - window_seconds
      properties:
        detail:
          type: string
          description: >-
            Missatge de denegació de pressupost existent, comprensible per a
            humans.
        reference:
          type: string
          pattern: ^RL-[0-9a-f]{32}$
          description: >-
            Referència de suport opaca: RL- seguit de 32 caràcters hexadecimals
            en minúscula d'un UUID.
        limit:
          type: integer
          description: Pressupost de l'àmbit superat; és igual a X-RateLimit-Limit.
        remaining:
          type: integer
          minimum: 0
          description: >-
            Pressupost restant, amb un mínim de zero; és igual que
            X-RateLimit-Remaining.
        reset:
          type: integer
          format: int64
          description: >-
            Temps de reinici de la finestra en segons Unix; és igual que
            X-RateLimit-Reset.
        window_seconds:
          type: integer
          description: >-
            Durada de la finestra fixa en segons, no l'espera restant. Respecta
            Retry-After abans de reintentar.
      example:
        detail: >-
          Write request rate limit exceeded. You can make up to 300 requests per
          minute.
        reference: RL-00000000000040008000000000000001
        limit: 300
        remaining: 0
        reset: 1794358860
        window_seconds: 60
    BankAccountHolder:
      type: object
      properties:
        name:
          type: string
        role:
          type: string
          enum:
            - holder
            - joint_holder
            - representative
            - unknown
      required:
        - name
        - role
    BankAccountIdentifiers:
      type: object
      description: >-
        Identificadors complets, retornats a les crides del costat del servidor
        amb el permís de dades bancàries.
      properties:
        iban:
          type: string
          description: IBAN complet, en majúscules i sense espais.
          nullable: true
        bic:
          type: string
          nullable: true
        account_number:
          type: string
          description: Número de compte local, quan el compte no té IBAN.
          nullable: true
        sort_code:
          type: string
          description: Codi de banc local, quan el compte no té IBAN.
          nullable: true
        other:
          type: array
          items:
            type: object
            properties:
              scheme:
                type: string
              value:
                type: string
            required:
              - scheme
              - value
          description: Qualsevol altre identificador que doni el banc.
      required:
        - iban
        - bic
        - account_number
        - sort_code
        - other
    BankAccountSync:
      type: object
      properties:
        last_synced_at:
          type: string
          description: Quan es van obtenir per última vegada del banc les dades del compte.
          format: date-time
          nullable: true
        status:
          type: string
          enum:
            - pending
            - ok
            - failed
        history_requested_from:
          type: string
          format: date
          nullable: true
        history_available_from:
          type: string
          description: >-
            La data de comptabilització més antiga que el banc ha lliurat
            realment per a aquest compte.
          format: date
          nullable: true
        pending_supported:
          type: boolean
          description: Si aquest banc informa de transaccions pendents.
      required:
        - last_synced_at
        - status
        - history_requested_from
        - history_available_from
        - pending_supported
    BankHistoryCoverage:
      type: object
      description: Què ha lliurat el banc de l'historial que has sol·licitat.
      properties:
        requested_from:
          type: string
          description: La data d'inici que s'ha demanat.
          format: date
          nullable: true
        oldest_booking_date:
          type: string
          description: >-
            La data de comptabilització més antiga que el banc ha lliurat
            realment.
          format: date
          nullable: true
        covered_ranges:
          type: array
          items:
            $ref: '#/components/schemas/BankDateRange'
        missing_ranges:
          type: array
          items:
            $ref: '#/components/schemas/BankDateRange'
        status:
          type: string
          enum:
            - complete
            - partial
            - empty
            - unavailable
            - unknown
          description: >-
            `partial`: el banc ha lliurat menys del que s'ha demanat. `empty`:
            el banc ha confirmat tota la finestra i no té transaccions.
            `unavailable`: el banc no ha proporcionat cap historial. `unknown`:
            encara no es coneix.
        extended_auth_used:
          type: boolean
          description: >-
            `true` quan la persona ha donat la confirmació addicional que alguns
            bancs demanen abans d'alliberar l'historial més antic.
      required:
        - requested_from
        - oldest_booking_date
        - covered_ranges
        - missing_ranges
        - status
        - extended_auth_used
    BankDateRange:
      type: object
      properties:
        from:
          type: string
          format: date
        to:
          type: string
          format: date
      required:
        - from
        - to
  responses:
    Unauthorized:
      description: No autoritzat
      content:
        application/json:
          examples:
            Invalid API Key:
              summary: Clau d'API no vàlida
              value:
                detail: Invalid API Key.
    BankDataAccessDenied:
      description: >-
        La clau d'API no té el permís Bank data (`bank-data`) o, per a dades
        bancàries sense processar en una aplicació de producció, la configuració
        de l'aplicació "Bank data in the API" està desactivada. Les dades
        bancàries no formen part de l'accés complet: una clau amb accés complet,
        una clau restringida a altres recursos i una sol·licitud autenticada
        sense clau d'API (credencials de client, sobre dades sense processar)
        són rebutjades amb aquest cos, així que crea una clau i concedeix-lo
        explícitament. El rebuig es produeix abans de cap cerca, de manera que
        no diu res sobre si un objecte existeix.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/BankDataError'
          examples:
            Bank data not allowed:
              summary: Dades bancàries no permeses
              value:
                code: bank_data_access_denied
                message: >-
                  Bank data calls need an API key that carries the Bank data
                  permission.
                request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                field: null
                next_action: enable_bank_data_access
                retry_after: null
    RateLimitedRead:
      description: >-
        S'ha superat el pressupost de lectura del middleware. Respecta
        Retry-After abans de reintentar.
      headers:
        Retry-After:
          $ref: '#/components/headers/BudgetRetryAfter'
        X-RateLimit-Scope:
          $ref: '#/components/headers/BudgetXRateLimitScope'
        X-RateLimit-Limit:
          $ref: '#/components/headers/BudgetXRateLimitLimit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/BudgetXRateLimitRemaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/BudgetXRateLimitReset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RateLimitBudgetError'
          example:
            detail: >-
              GET request rate limit exceeded. You can make up to 600 requests
              per minute.
            reference: RL-00000000000040008000000000000001
            limit: 600
            remaining: 0
            reset: 1794358860
            window_seconds: 60
    BankDataInternalError:
      description: >-
        Hi ha hagut un error per part de Didit. Qualsevol error inesperat sota
        `/v3/bank/` respon amb el format d'error de Bank, mai amb una pàgina
        HTML: cita el `request_id` quan contactis amb el servei de suport.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/BankDataError'
          examples:
            Internal error:
              summary: Un error inesperat
              value:
                code: internal_error
                message: >-
                  Something went wrong on our side. Quote the request_id to
                  support.
                request_id: 3f6a1c8e92b54d07a1e38c4b7f0d2e59
                field: null
                next_action: contact_support
                retry_after: null
  headers:
    BudgetRetryAfter:
      description: >-
        Nombre de segons que cal esperar, arrodonit fins a la finestra següent.
        Present en els rebutjos del pressupost del middleware.
      schema:
        type: integer
    BudgetXRateLimitScope:
      description: >-
        L'àmbit que ha superat el seu pressupost. Present en els rebutjos del
        pressupost del middleware.
      schema:
        type: string
    BudgetXRateLimitLimit:
      description: >-
        Pressupost de l'àmbit superat; és igual al límit del cos. Hi és present
        en les denegacions de pressupost del middleware.
      schema:
        type: integer
    BudgetXRateLimitRemaining:
      description: >-
        Pressupost restant, amb un mínim de zero; és igual que remaining del
        cos. Hi és present a les denegacions del pressupost del middleware.
      schema:
        type: integer
    BudgetXRateLimitReset:
      description: >-
        Temps de reinici en segons Unix; és igual que reset del cos. Present en
        els rebutjos del pressupost del middleware.
      schema:
        type: integer
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        La clau d'API de la teva aplicació, des de Developers -> API keys a la
        Business Console. La clau principal té accés complet. Una clau amb nom
        es pot limitar: cap, lectura o escriptura per recurs, limitada a alguns
        fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a
        una data de caducitat. 401 vol dir que la clau és incorrecta, revocada o
        caducada; 403 vol dir que no s'ha enviat cap clau, que la clau no té
        accés a aquest recurs o acció, o que la sol·licitud ve d'una adreça fora
        de la seva llista d'adreces IP; 404 en una ruta de sessió vol dir que la
        sessió queda fora dels fluxos de treball o estats de la clau. Una clau
        sense accés a multimèdia rep les URL d'imatges, vídeos i PDF com a null,
        i una clau sense escriptura de sessions rep els enllaços i els tokens de
        sessió com a null. Vegeu https://docs.didit.me/console/api-keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.