> ## 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 per elencare le transazioni bancarie: intervallo di date, contabilizzate e in sospeso

> L'endpoint List Transactions di Didit legge le transazioni di un conto per periodo, contabilizzate e in sospeso, con paginazione tramite page token.

L'endpoint List Transactions di Didit legge le transazioni di un conto per un intervallo di date, sia contabilizzate sia in sospeso, con paginazione basata su token di pagina.
Gli importi sono stringhe decimali, e i campi che una banca non invia sono `null`.
Per mantenere una copia allineata, usa il [feed delle modifiche](https://docs.didit.me/it/standalone-apis/bank-transactions-sync.md) invece di rileggere gli intervalli.


## OpenAPI

````yaml it/openapi-25.json GET /v3/bank/accounts/{account_id}/transactions/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API di verifica dell'identità. Autenticati con l'header x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags:
  - name: Bank Data
    description: >-
      Bank Link, connessioni, conti, saldi, transazioni, istituti e copertura. I
      dati bancari sono disponibili per le applicazioni sandbox. Le chiamate di
      un'applicazione in produzione restituiscono `404` finché l'accesso di
      produzione non viene annunciato. Nel sandbox non viene addebitato nulla.
      Una chiamata effettuata con una chiave API richiede una chiave che abbia
      l'autorizzazione dati bancari (`bank-data`): lettura per le letture,
      scrittura per le operazioni che modificano qualcosa. Il controllo del
      conto fa eccezione: richiede accesso in scrittura alle sessioni, oppure
      accesso completo, e non l'autorizzazione dati bancari. I dati bancari non
      fanno parte dell'accesso completo: una chiave con accesso completo viene
      rifiutata e la chiamata risponde `403 bank_data_access_denied` finché non
      crei una chiave che abbia l'autorizzazione. I dati bancari grezzi (conti,
      saldi, transazioni e flusso delle modifiche) rifiutano anche una richiesta
      che non contiene una chiave API.


      Ogni rifiuto sotto `/v3/bank/`, eccetto quello del controllo del conto, ha
      lo stesso corpo JSON (`code`, `message`, `request_id`, `field`,
      `next_action`, `retry_after`). Un percorso che non è un'operazione, un ID
      che non è un UUID o una sotto-risorsa sconosciuta risponde `404 not_found`
      per ogni metodo, e qualsiasi errore imprevisto risponde `500
      internal_error` con un `request_id`. Dove i dati bancari non sono
      disponibili, ogni operazione risponde con il `404` standard della
      piattaforma, esattamente come fa un percorso sconosciuto.
paths:
  /v3/bank/accounts/{account_id}/transactions/:
    get:
      tags:
        - Bank Data
      summary: Elenca le transazioni del conto
      description: >-
        Lettura per intervallo di date delle transazioni di un conto, ordinate
        per `effective_date` decrescente e poi per `id` decrescente, in pagine
        di massimo 500 elementi. `date_from` e `date_to` sono date di
        calendario, estremi inclusi, nel fuso orario della banca, senza alcuna
        conversione. Si applicano a `effective_date`: per una transazione
        contabilizzata corrisponde alla data di contabilizzazione, altrimenti
        alla data valuta, altrimenti alla data in cui è stata rilevata per la
        prima volta; per una transazione in sospeso corrisponde alla data della
        transazione, altrimenti alla data in cui è stata rilevata per la prima
        volta. Per impostazione predefinita `date_from` corrisponde all'inizio
        dello storico memorizzato, `date_to` non ha un limite superiore, e
        vengono restituite sia le transazioni contabilizzate sia quelle in
        sospeso.


        La prima pagina fissa le transazioni incluse, e ciascuna viene
        restituita nel suo stato attuale: una transazione rimossa durante la
        paginazione non compare nelle pagine successive ed è segnalata dal feed
        delle modifiche (`sync_transactions`). `page_token` prosegue una sola
        lettura e resta valido per un'ora; un token scaduto restituisce `410
        page_expired`, quindi riavvia la lettura dalla query originale. Per
        mantenere aggiornata una copia, usa il feed delle modifiche invece di
        rileggere gli intervalli.


        Intestazioni della risposta: `X-Bank-Last-Synced-At` e `Cache-Control:
        no-store`.


        Richiede una chiave API con il permesso Bank data (`bank-data`): lettura
        per questa operazione. Una chiave con accesso completo non include
        questo permesso: concedilo esplicitamente quando crei la chiave,
        altrimenti la chiamata restituisce `403 bank_data_access_denied`.
        Un'applicazione sandbox legge i dati bancari di prova con la sola
        chiave. Una richiesta senza chiave API (credenziali client) viene
        rifiutata sui dati grezzi con lo stesso `403`.
      operationId: listBankTransactions
      parameters:
        - name: account_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: L'id del conto.
        - name: date_from
          in: query
          required: false
          schema:
            type: string
            format: date
          description: Prima data di efficacia da includere, inclusa.
        - name: date_to
          in: query
          required: false
          schema:
            type: string
            format: date
          description: >-
            Ultima data di efficacia da includere, inclusa. Nessun limite
            superiore se la ometti.
        - name: status
          in: query
          required: false
          schema:
            type: string
            enum:
              - booked
              - pending
          description: >-
            Solo transazioni contabilizzate o solo transazioni in attesa.
            Predefinito: entrambe.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 100
            minimum: 1
            maximum: 500
          description: 'Dimensione della pagina, da 1 a 500. Predefinito: 100.'
        - name: page_token
          in: query
          required: false
          schema:
            type: string
          description: Il `next_page_token` della pagina precedente.
      responses:
        '200':
          description: Una pagina di transazioni.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankTransactionPage'
              examples:
                Booked and pending:
                  summary: Due transazioni contabilizzate e una in sospeso
                  value:
                    items:
                      - id: e5b1f8a3-0d47-4c92-a6e0-7f3c2d9b1845
                        account_id: a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10
                        status: pending
                        pending_id: null
                        reverses_id: null
                        booking_date: null
                        value_date: null
                        transaction_date: '2026-11-21'
                        effective_date: '2026-11-21'
                        amount: '-64.90'
                        currency: EUR
                        direction: debit
                        description: PAGO TARJETA PAPELERIA CENTRAL
                        counterparty:
                          name: PAPELERIA CENTRAL
                          iban: null
                          bic: null
                        remittance:
                          unstructured: []
                          structured: null
                          reference: null
                        bank_transaction_code: null
                        bank_reference: null
                        identity_quality: derived
                        end_to_end_id: null
                        mandate_id: null
                        creditor_id: null
                        merchant_category_code: '5943'
                        exchange: null
                        balance_after: null
                        category: office_supplies
                        first_seen_at: '2026-11-21T12:04:40Z'
                        updated_at: '2026-11-21T12:04:40Z'
                      - id: 8f2b6d41-9c3a-4e57-b0d8-1a7e5c4f2963
                        account_id: a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10
                        status: booked
                        pending_id: null
                        reverses_id: null
                        booking_date: '2026-11-19'
                        value_date: '2026-11-20'
                        transaction_date: null
                        effective_date: '2026-11-19'
                        amount: '-1210.00'
                        currency: EUR
                        direction: debit
                        description: RECIBO SEGURIDAD SOCIAL
                        counterparty:
                          name: ENTIDAD PUBLICA DE EJEMPLO
                          iban: ES0000000000000000005766
                          bic: null
                        remittance:
                          unstructured:
                            - RECIBO SEGURIDAD SOCIAL 10/2026
                          structured: null
                          reference: '0028123456789'
                        bank_transaction_code: PMNT-RDDT-ESDD
                        bank_reference: '2026111900012345'
                        identity_quality: bank_reference
                        end_to_end_id: NOTPROVIDED
                        mandate_id: ES-SS-000123
                        creditor_id: ES00ZZZ00000000
                        merchant_category_code: null
                        exchange: null
                        balance_after: '18250.34'
                        category: taxes_and_social_security
                        first_seen_at: '2026-11-20T06:00:12Z'
                        updated_at: '2026-11-20T06:00:12Z'
                      - id: 2c9e7a05-6b14-4d38-8f2a-b3d51e0c9a67
                        account_id: a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10
                        status: booked
                        pending_id: null
                        reverses_id: null
                        booking_date: '2026-11-18'
                        value_date: '2026-11-18'
                        transaction_date: null
                        effective_date: '2026-11-18'
                        amount: '3450.00'
                        currency: EUR
                        direction: credit
                        description: TRANSFERENCIA FACTURA 2026-0418
                        counterparty:
                          name: CLIENTE DE EJEMPLO SL
                          iban: ES0000000000000000007891
                          bic: null
                        remittance:
                          unstructured:
                            - FRA 2026-0418
                          structured: null
                          reference: null
                        bank_transaction_code: PMNT-RCDT-ESCT
                        bank_reference: '2026111800009876'
                        identity_quality: bank_reference
                        end_to_end_id: 2026-0418
                        mandate_id: null
                        creditor_id: null
                        merchant_category_code: null
                        exchange: null
                        balance_after: '19460.34'
                        category: income
                        first_seen_at: '2026-11-19T06:00:10Z'
                        updated_at: '2026-11-19T06:00:10Z'
                    next_page_token: null
                    has_more: false
          headers:
            X-Bank-Last-Synced-At:
              description: >-
                Quando i dati del conto sono stati recuperati l'ultima volta
                dalla banca. Presente una volta che il conto è stato
                sincronizzato.
              schema:
                type: string
                format: date-time
            Cache-Control:
              description: '`no-store`.'
              schema:
                type: string
        '400':
          description: >-
            Il token di pagina non è valido o appartiene a un'altra lettura,
            oppure un parametro è fuori intervallo (incluso `date_from`
            successivo a `date_to`). `field` ne indica il nome.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Invalid token:
                  summary: Token non valido
                  value:
                    code: invalid_cursor
                    message: The cursor or page token is not valid.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: page_token
                    next_action: null
                    retry_after: null
                Token for another read:
                  summary: Token per un'altra lettura
                  value:
                    code: page_token_mismatch
                    message: >-
                      The page token belongs to a different read. Restart with
                      the same filters.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: page_token
                    next_action: null
                    retry_after: null
                Invalid request:
                  summary: Richiesta non valida
                  value:
                    code: invalid_request
                    message: The request is not valid.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: date_from
                    next_action: null
                    retry_after: null
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/BankDataAccessDenied'
        '404':
          description: La risorsa non esiste in questa applicazione e in questo ambiente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Not found:
                  summary: Non trovato
                  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 persona non condivide più questo conto (`access_removed`), oppure
            la connessione è stata eliminata o i suoi dati non sono più
            leggibili (`connection_not_active`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Access removed:
                  summary: Accesso rimosso
                  value:
                    code: access_removed
                    message: The person no longer shares this account.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: null
                    next_action: null
                    retry_after: null
        '410':
          description: Il page_token è scaduto.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Page expired:
                  summary: Pagina scaduta
                  value:
                    code: page_expired
                    message: The page token expired. Restart the read.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: page_token
                    next_action: restart_read
                    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/accounts/a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10/transactions/?date_from=2026-01-01&date_to=2026-11-21&status=booked'
            \
              -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_transactions(
                "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.listTransactions("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.ListTransactions(ctx, \"11111111-2222-3333-4444-555555555555\", didit.BankListTransactionsParams{})\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().listTransactions("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->listTransactions('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_transactions("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.ListTransactionsAsync("11111111-2222-3333-4444-555555555555");

            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  schemas:
    BankTransactionPage:
      type: object
      description: >-
        Una pagina di una lettura per intervallo di date. La prima pagina fissa
        le transazioni incluse e ciascuna viene restituita nel suo stato
        attuale; una transazione rimossa durante la paginazione non compare
        nelle pagine successive ed è segnalata dal feed delle modifiche.
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/BankTransaction'
          description: Ordinati per `effective_date` in ordine decrescente, poi per `id`.
        next_page_token:
          type: string
          description: >-
            Prosegue questa lettura. Fissa lo snapshot della prima pagina, dura
            un'ora ed è legato all'applicazione, all'ambiente, al conto e ai
            filtri della lettura.
          nullable: true
        has_more:
          type: boolean
      required:
        - items
        - next_page_token
        - has_more
    BankDataError:
      type: object
      description: >-
        Corpo dell'errore di ogni operazione Bank data. Ogni campo è sempre
        presente.
      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: >-
            Codice di errore leggibile dalla macchina. Usalo per la diramazione
            della logica, mai `message`.
        message:
          type: string
          description: >-
            Spiegazione in linguaggio semplice per uno sviluppatore. Il testo
            può cambiare; non analizzarlo.
        request_id:
          type: string
          description: >-
            Identificativo di questa richiesta. Citalo quando contatti il
            supporto.
        field:
          type: string
          description: >-
            Il campo della richiesta da correggere, quando l'errore riguarda un
            solo campo. Altrimenti `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: >-
            Cosa fare dopo, così un client può agire senza fare supposizioni.
            `null` quando non esiste un passaggio successivo standard.
          nullable: true
        retry_after:
          type: integer
          description: >-
            Secondi da attendere prima di riprovare. Impostato in caso di limite
            di frequenza ed errori temporanei, altrimenti `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
    BankTransaction:
      type: object
      description: >-
        Un movimento di un conto. Ogni campo che la banca non invia è `null`; le
        capacità dell'istituto elencano quali campi una banca invia, secondo
        quanto osservato.
      properties:
        id:
          type: string
          description: >-
            Id Didit, opaco e memorizzato al primo rilevamento. Lo stesso
            movimento mantiene il suo id tra letture, sincronizzazioni e
            rinnovi. `identity_quality` indica quanto è forte questa garanzia.
          format: uuid
        account_id:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - booked
            - pending
          description: >-
            Una transazione in sospeso ha un proprio id. Quando la banca la
            contabilizza, la transazione contabilizzata riporta `pending_id`
            dove la banca le collega, e quella in sospeso compare in `removed`
            con `reason: pending_booked`.
        pending_id:
          type: string
          description: >-
            La transazione in sospeso che questa sostituisce. Impostata solo
            quando la banca le collega, mai dedotta.
          format: uuid
          nullable: true
        reverses_id:
          type: string
          description: >-
            La transazione che questa annulla, quando la banca le collega. Uno
            storno è una nuova transazione.
          format: uuid
          nullable: true
        booking_date:
          type: string
          format: date
          nullable: true
        value_date:
          type: string
          format: date
          nullable: true
        transaction_date:
          type: string
          format: date
          nullable: true
        effective_date:
          type: string
          description: >-
            La data che usano i filtri per data, così come la riporta la banca
            nel proprio fuso orario, senza alcuna conversione: per una
            transazione contabilizzata è la sua data di contabilizzazione,
            altrimenti la sua data valuta, altrimenti la data in cui è stata
            rilevata per la prima volta; per una transazione in sospeso è la sua
            data della transazione, altrimenti la data in cui è stata rilevata
            per la prima volta.
          format: date
        amount:
          type: string
          description: >-
            Importo con segno, come stringa decimale. Il valore negativo indica
            un'uscita di denaro.
          pattern: ^-?\d+(\.\d+)?$
        currency:
          type: string
          pattern: ^[A-Z]{3}$
          description: Codice valuta ISO 4217.
        direction:
          type: string
          enum:
            - credit
            - debit
          description: Ripete il segno di `amount`.
        description:
          type: string
          nullable: true
        counterparty:
          $ref: '#/components/schemas/BankTransactionCounterparty'
        remittance:
          $ref: '#/components/schemas/BankTransactionRemittance'
        bank_transaction_code:
          type: string
          nullable: true
        bank_reference:
          type: string
          description: >-
            Il riferimento immutabile della voce della banca, quando la banca lo
            fornisce. `null` altrimenti, mai inventato.
          nullable: true
        identity_quality:
          type: string
          enum:
            - bank_reference
            - route_id
            - derived
          description: >-
            Come è stato abbinato `id`. `bank_reference` e `route_id` sono
            stabili. `derived` viene abbinato per contenuto: è stabile finché la
            banca continua a riportare la voce invariata, e una correzione della
            banca può quindi comparire come una `removed` e una `added`.
        end_to_end_id:
          type: string
          nullable: true
        mandate_id:
          type: string
          nullable: true
        creditor_id:
          type: string
          nullable: true
        merchant_category_code:
          type: string
          nullable: true
        exchange:
          type: object
          nullable: true
          description: Dettagli sul cambio valuta, dove la banca li fornisce.
          properties:
            source_amount:
              type: string
              pattern: ^-?\d+(\.\d+)?$
              nullable: true
            source_currency:
              type: string
              nullable: true
            rate:
              type: string
              pattern: ^-?\d+(\.\d+)?$
              nullable: true
        balance_after:
          type: string
          description: Saldo dopo la transazione, quando la banca lo fornisce.
          pattern: ^-?\d+(\.\d+)?$
          nullable: true
        category:
          type: string
          description: Categoria propria di Didit, quando applicabile.
          nullable: true
        first_seen_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - id
        - account_id
        - status
        - pending_id
        - reverses_id
        - booking_date
        - value_date
        - transaction_date
        - effective_date
        - amount
        - currency
        - direction
        - description
        - counterparty
        - remittance
        - bank_transaction_code
        - bank_reference
        - identity_quality
        - end_to_end_id
        - mandate_id
        - creditor_id
        - merchant_category_code
        - exchange
        - balance_after
        - category
        - first_seen_at
        - updated_at
    RateLimitBudgetError:
      type: object
      description: >-
        Restituito solo per un rifiuto del budget del middleware del limite di
        frequenza. Altri errori 429, inclusi i conflitti di idempotenza e i
        limiti specifici dell'endpoint, non garantiscono questi campi di
        metadati.
      required:
        - detail
        - reference
        - limit
        - remaining
        - reset
        - window_seconds
      properties:
        detail:
          type: string
          description: Messaggio di rifiuto per budget leggibile, già esistente.
        reference:
          type: string
          pattern: ^RL-[0-9a-f]{32}$
          description: >-
            Riferimento di supporto opaco: RL- seguito da 32 caratteri
            esadecimali minuscoli di un UUID.
        limit:
          type: integer
          description: Budget per l'ambito superato; equivale a X-RateLimit-Limit.
        remaining:
          type: integer
          minimum: 0
          description: Budget residuo, limitato a zero; equivale a X-RateLimit-Remaining.
        reset:
          type: integer
          format: int64
          description: >-
            Orario di reset della finestra in secondi Unix; coincide con
            X-RateLimit-Reset.
        window_seconds:
          type: integer
          description: >-
            Durata della finestra fissa in secondi, non il tempo di attesa
            residuo. Rispetta Retry-After prima di riprovare.
      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
    BankTransactionCounterparty:
      type: object
      properties:
        name:
          type: string
          nullable: true
        iban:
          type: string
          nullable: true
        bic:
          type: string
          nullable: true
      required:
        - name
        - iban
        - bic
    BankTransactionRemittance:
      type: object
      properties:
        unstructured:
          type: array
          items:
            type: string
        structured:
          type: string
          nullable: true
        reference:
          type: string
          nullable: true
      required:
        - unstructured
        - structured
        - reference
  responses:
    Unauthorized:
      description: Non autorizzato
      content:
        application/json:
          examples:
            Invalid API Key:
              summary: Chiave API non valida
              value:
                detail: Invalid API Key.
    BankDataAccessDenied:
      description: >-
        La chiave API non ha l'autorizzazione Bank data (`bank-data`) oppure,
        per i dati bancari grezzi in un'applicazione live, l'impostazione
        dell'applicazione "Bank data in the API" è disattivata. I dati bancari
        non fanno parte dell'accesso completo: una chiave con accesso completo,
        una chiave limitata ad altre risorse e una richiesta autenticata senza
        chiave API (client credentials, sui dati grezzi) vengono tutte rifiutate
        con questo messaggio, quindi crea una chiave e concedi l'autorizzazione
        in modo esplicito. Il rifiuto avviene prima di qualsiasi ricerca, quindi
        non dice nulla sull'esistenza di un oggetto.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/BankDataError'
          examples:
            Bank data not allowed:
              summary: Accesso ai dati bancari non consentito
              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: >-
        Budget di lettura del middleware superato. Rispetta Retry-After prima di
        riprovare.
      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: >-
        Si è verificato un problema lato Didit. Qualsiasi errore imprevisto
        sotto `/v3/bank/` risponde nel formato di errore Bank, mai con una
        pagina HTML: indica `request_id` al supporto.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/BankDataError'
          examples:
            Internal error:
              summary: Un errore imprevisto
              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: >-
        Secondi di attesa, arrotondati alla finestra successiva. Presente nei
        rifiuti per budget del middleware.
      schema:
        type: integer
    BudgetXRateLimitScope:
      description: >-
        L'ambito il cui budget è stato superato. Presente nei rifiuti per budget
        del middleware.
      schema:
        type: string
    BudgetXRateLimitLimit:
      description: >-
        Budget per l'ambito superato; equivale al limite nel corpo. Presente nei
        rifiuti per budget del middleware.
      schema:
        type: integer
    BudgetXRateLimitRemaining:
      description: >-
        Budget residuo, limitato a zero; equivale a remaining nel corpo.
        Presente nei rifiuti per budget del middleware.
      schema:
        type: integer
    BudgetXRateLimitReset:
      description: >-
        Orario di reset in secondi Unix; coincide con il reset nel corpo.
        Presente nei rifiuti per budget del middleware.
      schema:
        type: integer
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        La chiave API della tua applicazione, da Developers -> API keys nella
        Business Console. La chiave primaria ha accesso completo. Una chiave con
        nome può avere ambiti limitati: nessuno, lettura o scrittura per
        risorsa, limitata ad alcuni workflow o solo alle sessioni approvate, a
        un elenco di indirizzi IP e a una data di scadenza. 401 significa che la
        chiave è errata, revocata o scaduta; 403 significa che non è stata
        inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o
        azione, oppure che la richiesta proviene da un indirizzo esterno alla
        sua lista IP; 404 su una route di sessione significa che la sessione è
        al di fuori dei workflow o degli stati consentiti alla chiave. Una
        chiave senza accesso ai media riceve gli URL di immagini, video e PDF
        come null, e una chiave senza permesso di scrittura sulle sessioni
        riceve i link e i token delle sessioni come null. Vedi
        https://docs.didit.me/console/api-keys.

````

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