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

# Daftar Koneksi Bank API: Filter Status dan Persetujuan

> Didit mengembalikan daftar koneksi bank Anda, bisa difilter berdasarkan status, akses, bank, negara, referensi, dan tanggal akhir persetujuan.

Endpoint Daftar Koneksi Bank dari Didit mengembalikan koneksi bank Anda, yang dapat difilter berdasarkan status, akses, bank, negara, referensi Anda sendiri, dan tanggal berakhir persetujuan.
Gunakan `consent_expires_before` untuk menemukan persetujuan yang perlu diperpanjang, dan `end_user_reference` untuk menemukan koneksi milik satu pelanggan.
Daftar ini dibagi ke dalam beberapa halaman menggunakan `cursor`.


## OpenAPI

````yaml id/openapi-25.json GET /v3/bank/connections/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API Verifikasi Identitas. Lakukan autentikasi dengan header x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags:
  - name: Bank Data
    description: >-
      Bank Link, koneksi, akun, saldo, transaksi, institusi, dan cakupan. Data
      bank tersedia untuk aplikasi sandbox. Panggilan dari aplikasi produksi
      mengembalikan `404` hingga akses live diumumkan. Tidak ada biaya yang
      dikenakan di sandbox. Panggilan yang dibuat dengan kunci API memerlukan
      kunci yang memiliki izin Bank data (`bank-data`): baca untuk operasi baca,
      tulis untuk operasi yang mengubah sesuatu. Pemeriksaan akun adalah
      pengecualian: memerlukan akses tulis ke sesi, atau akses penuh, dan bukan
      izin Bank data. Bank data bukan bagian dari akses penuh: kunci akses penuh
      ditolak, dan panggilan menjawab `403 bank_data_access_denied` hingga Anda
      membuat kunci yang memiliki izin tersebut. Data bank mentah (akun, saldo,
      transaksi, dan umpan perubahan) juga menolak permintaan yang tidak
      menyertakan kunci API.


      Setiap penolakan di bawah `/v3/bank/` kecuali milik pemeriksaan akun
      memiliki badan JSON yang sama (`code`, `message`, `request_id`, `field`,
      `next_action`, `retry_after`). Jalur yang bukan operasi, ID yang bukan
      UUID, atau sub-resource yang tidak dikenal menjawab `404 not_found` untuk
      semua metode, dan kesalahan tak terduga apa pun menjawab `500
      internal_error` dengan `request_id`. Jika Bank data tidak tersedia, setiap
      operasi menjawab `404` standar platform, sama seperti rute yang tidak
      dikenal.
paths:
  /v3/bank/connections/:
    get:
      tags:
        - Bank Data
      summary: Daftar koneksi bank
      description: >-
        Menampilkan daftar koneksi aplikasi Anda, dari yang terbaru, dengan
        paginasi berbasis kursor. Semua filter berlaku di dalam aplikasi dan
        lingkungan Anda.


        Membutuhkan kunci API dengan izin Data bank (`bank-data`): izin read
        untuk operasi ini. Kunci dengan akses penuh tidak menyertakannya:
        berikan secara eksplisit saat Anda membuat kunci, atau panggilan akan
        menjawab `403 bank_data_access_denied`.


        Dalam daftar ini, `sync.budgets` hanya menampilkan anggaran yang sudah
        ada; `GET /v3/bank/connections/{id}/` membuka anggaran hari ini.
      operationId: listBankConnections
      parameters:
        - name: status
          in: query
          required: false
          schema:
            type: string
            enum:
              - pending
              - active
              - renewal_required
              - paused
              - revoked
              - deleted
              - failed
          description: Hanya koneksi dengan status ini.
        - name: access
          in: query
          required: false
          schema:
            type: string
            enum:
              - one_time
              - ongoing
          description: Hanya mode akses ini.
        - name: institution_id
          in: query
          required: false
          schema:
            type: string
            maxLength: 64
          description: Hanya bank ini.
        - name: country
          in: query
          required: false
          schema:
            type: string
            pattern: ^[A-Z]{3}$
          description: Hanya bank di negara ini.
        - name: vendor_data
          in: query
          required: false
          schema:
            type: string
            maxLength: 255
          description: Hanya koneksi dengan `vendor_data` ini.
        - name: end_user_reference
          in: query
          required: false
          schema:
            type: string
            maxLength: 255
          description: Hanya koneksi dengan `end_user.reference` ini.
        - name: consent_expires_before
          in: query
          required: false
          schema:
            type: string
            format: date-time
          description: >-
            Hanya koneksi yang persetujuannya berakhir sebelum waktu ini,
            misalnya untuk mengirim tautan perpanjangan.
        - name: created_after
          in: query
          required: false
          schema:
            type: string
            format: date-time
          description: Hanya koneksi yang dibuat setelah waktu ini.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 100
            minimum: 1
            maximum: 500
          description: Ukuran halaman, 1 hingga 500. Default 100.
        - name: cursor
          in: query
          required: false
          schema:
            type: string
          description: Kursor opak dari `next_cursor` halaman sebelumnya.
      responses:
        '200':
          description: Satu halaman koneksi.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankConnectionList'
              examples:
                Page:
                  summary: Satu koneksi
                  value:
                    items:
                      - id: 5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35
                        environment: live
                        access: ongoing
                        status: active
                        status_reason: null
                        institution:
                          id: es-banco-norte
                          name: Banco Norte
                          country: ESP
                          logo_url: https://static.example.com/banks/es-banco-norte.png
                        segment: business
                        data:
                          - accounts
                          - balances
                          - transactions
                        consent:
                          status: granted
                          version: 1
                          granted_at: '2026-11-21T12:04:11Z'
                          expires_at: '2027-05-20T12:04:11Z'
                          days_granted: 180
                          renewed_count: 0
                          scopes_requested:
                            - accounts
                            - balances
                            - transactions
                          scopes_granted:
                            - accounts
                            - balances
                            - transactions
                          accounts_granted:
                            - a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10
                            - c3d84e19-2a7b-4f60-b5e1-9a0c6d3f8e72
                          renewal_action: bank_auth
                          renew_by: '2027-05-20T12:04:11Z'
                          reconfirm_by: null
                          renewable_until: null
                          retain_until: null
                          ended_at: null
                          ended_by: null
                        sync:
                          status: ok
                          initial_status: succeeded
                          initial_complete: true
                          history_complete: true
                          last_synced_at: '2026-11-21T12:04:40Z'
                          next_sync_at: '2026-11-22T06:00:00Z'
                          budgets:
                            - scope: connection
                              resource: all
                              limit: 4
                              remaining: 3
                              resets_at: '2026-11-22T00:00:00Z'
                          last_error: null
                          frequency_per_day: 1
                          live_syncs_left_today: 3
                        accounts:
                          - id: a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10
                            name: Cuenta negocio
                            type: current
                            usage: business
                            currency: EUR
                            iban_last4: '1332'
                            status: open
                          - id: c3d84e19-2a7b-4f60-b5e1-9a0c6d3f8e72
                            name: Cuenta de ahorro
                            type: savings
                            usage: business
                            currency: EUR
                            iban_last4: '7708'
                            status: open
                        ownership:
                          compare: none
                          match: null
                          check_id: null
                          result: null
                        end_user:
                          reference: client-7731
                        manage_url: null
                        billing:
                          unit: connection_month
                          price_usd: '0.9000'
                          billed_through: '2026-11-30'
                        possible_duplicate_of: null
                        erasure: null
                        vendor_data: client-7731
                        created_at: '2026-11-21T12:03:02Z'
                        updated_at: '2026-11-21T12:04:40Z'
                    next_cursor: null
        '400':
          description: Sebuah parameter tidak valid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Invalid cursor:
                  summary: Kursor tidak valid
                  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: Permintaan tidak valid
                  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'
        '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/?status=active&country=ESP&limit=50'
            \
              -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_connections()
            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.listConnections();
            console.log(result);
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Bank.ListConnections(ctx, didit.BankListConnectionsParams{})\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().listConnections();
            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->listConnections();
            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

            # Reads DIDIT_API_KEY.
            didit = Didit::Client.new

            result = didit.bank.list_connections
            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.ListConnectionsAsync();
            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  schemas:
    BankConnectionList:
      type: object
      description: Satu halaman koneksi.
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/BankConnection'
        next_cursor:
          type: string
          description: >-
            Kirim sebagai `cursor` untuk halaman berikutnya. `null` pada halaman
            terakhir.
          nullable: true
      required:
        - items
        - next_cursor
    BankDataError:
      type: object
      description: Isi kesalahan dari setiap operasi Bank data. Setiap kolom selalu ada.
      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: >-
            Kode error yang dapat dibaca mesin. Tentukan percabangan berdasarkan
            kode ini, jangan berdasarkan `message`.
        message:
          type: string
          description: >-
            Penjelasan dalam bahasa sederhana untuk pengembang. Redaksinya dapat
            berubah; jangan diurai.
        request_id:
          type: string
          description: ID permintaan ini. Sertakan ID ini saat menghubungi dukungan.
        field:
          type: string
          description: >-
            Kolom permintaan yang perlu diperbaiki, jika error berkaitan dengan
            satu kolom. Jika tidak, bernilai `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: >-
            Apa langkah berikutnya, agar klien dapat bertindak tanpa menebak.
            `null` jika tidak ada langkah berikutnya yang standar.
          nullable: true
        retry_after:
          type: integer
          description: >-
            Detik untuk menunggu sebelum mencoba lagi. Diisi pada error batas
            laju dan error sementara; jika tidak, `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
    BankConnection:
      type: object
      description: >-
        Izin dari orang tersebut agar aplikasi Anda dapat membaca data satu
        bank. Perpanjangan mempertahankan ID koneksi dan semua ID akun. Koneksi
        yang dihapus hanya mengembalikan `id`, `status`, `status_reason`,
        `created_at` dan `erasure`. Semua kolom lain tidak ada, dan tidak ada
        data bank, orang, atau akun yang tersisa di dalamnya.
      properties:
        id:
          type: string
          description: ID koneksi.
          format: uuid
        environment:
          type: string
          enum:
            - live
            - sandbox
        access:
          type: string
          enum:
            - one_time
            - ongoing
        status:
          type: string
          enum:
            - pending
            - active
            - renewal_required
            - paused
            - revoked
            - deleted
            - failed
          description: >-
            `pending`: sinkronisasi pertama sedang berjalan. `active`:
            persetujuan berlaku. `renewal_required`: persetujuan berakhir atau
            bank meminta orang tersebut masuk kembali; data dapat dibaca
            sebagaimana terakhir disinkronkan dan tidak ada biaya. `paused`:
            saldo terlalu rendah untuk bulan tersebut. `revoked`: akses
            dihentikan oleh orang tersebut, bank, atau Anda. `deleted`: hanya
            `id`, `status`, `status_reason`, `created_at` dan `erasure` yang
            tersisa. `failed`: sinkronisasi pertama tidak pernah berhasil.
        status_reason:
          type: string
          enum:
            - collection_complete
            - consent_expired
            - consent_lapsed
            - bank_requires_sign_in
            - revoked_by_end_user
            - revoked_by_bank
            - revoked_by_customer
            - insufficient_balance
            - paused_by_customer
            - first_sync_failed
            - deleted_by_customer
            - retention_elapsed
            - application_deleted
            - null
          description: >-
            Alasan koneksi berada dalam status ini. `paused_by_customer`
            dicadangkan. Pada koneksi `deleted`: `deleted_by_customer`,
            `consent_lapsed`, `retention_elapsed` atau `application_deleted`.
          nullable: true
        institution:
          $ref: '#/components/schemas/BankInstitutionSummary'
        segment:
          type: string
          enum:
            - personal
            - business
            - null
          nullable: true
        data:
          type: array
          items:
            type: string
            enum:
              - accounts
              - balances
              - transactions
          description: Cakupan yang diterima orang tersebut.
        consent:
          $ref: '#/components/schemas/BankConnectionConsent'
        sync:
          $ref: '#/components/schemas/BankConnectionSync'
        accounts:
          type: array
          items:
            $ref: '#/components/schemas/BankConnectionAccountSummary'
          description: >-
            Ringkasan setiap akun dalam koneksi. Baca akun lengkap dengan
            `get_account`.
        ownership:
          $ref: '#/components/schemas/BankConnectionOwnership'
        end_user:
          type: object
          properties:
            reference:
              type: string
              description: Id Anda untuk orang atau perusahaan.
              nullable: true
          required:
            - reference
        manage_url:
          type: string
          description: >-
            Halaman akses milik orang tersebut. Bernilai `null` sampai halaman
            akses tersedia.
          nullable: true
          format: uri
        billing:
          $ref: '#/components/schemas/BankConnectionBilling'
        possible_duplicate_of:
          type: string
          description: >-
            Diisi ketika koneksi ini mungkin menduplikasi koneksi aktif lain,
            tetapi tidak ada `end_user.reference` yang memungkinkan kecocokan
            tertentu.
          format: uuid
          nullable: true
        erasure:
          allOf:
            - $ref: '#/components/schemas/BankConnectionErasure'
          nullable: true
          description: Diisi setelah `delete_connection`; jika tidak, `null`.
        vendor_data:
          type: string
          nullable: true
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - id
        - status
        - status_reason
        - created_at
        - erasure
    RateLimitBudgetError:
      type: object
      description: >-
        Hanya dikembalikan untuk penolakan anggaran batas laju middleware.
        Kesalahan 429 lainnya, termasuk konflik idempotensi dan batas khusus
        endpoint, tidak menjamin bidang metadata ini.
      required:
        - detail
        - reference
        - limit
        - remaining
        - reset
        - window_seconds
      properties:
        detail:
          type: string
          description: Pesan penolakan anggaran yang sudah ada dan mudah dibaca manusia.
        reference:
          type: string
          pattern: ^RL-[0-9a-f]{32}$
          description: >-
            Referensi dukungan (tidak transparan): RL- diikuti 32 karakter
            heksadesimal UUID huruf kecil.
        limit:
          type: integer
          description: >-
            Anggaran untuk cakupan yang terlampaui; sama dengan
            X-RateLimit-Limit.
        remaining:
          type: integer
          minimum: 0
          description: >-
            Sisa anggaran, dibatasi hingga nol; sama dengan
            X-RateLimit-Remaining.
        reset:
          type: integer
          format: int64
          description: Waktu reset jendela dalam detik Unix; sama dengan X-RateLimit-Reset.
        window_seconds:
          type: integer
          description: >-
            Durasi jendela tetap dalam detik, bukan sisa waktu tunggu. Patuhi
            Retry-After sebelum mencoba lagi.
      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
    BankInstitutionSummary:
      type: object
      description: Bank untuk koneksi atau tautan tersebut.
      properties:
        id:
          type: string
          description: >-
            Pengidentifikasi bank dari Didit, berupa slug yang stabil. Gunakan
            sebagai `institution_id`.
          example: es-banco-norte
        name:
          type: string
          description: Nama bank.
          example: Banco Norte
        country:
          type: string
          description: Negara bank, ISO 3166-1 alpha-3.
          pattern: ^[A-Z]{3}$
          example: ESP
        logo_url:
          type: string
          description: Logo bank, atau `null`.
          nullable: true
          format: uri
      required:
        - id
        - name
        - country
        - logo_url
    BankConnectionConsent:
      type: object
      description: Persetujuan orang tersebut untuk koneksi ini.
      properties:
        status:
          type: string
          enum:
            - granted
            - expired
            - revocation_pending
            - revoked
            - revocation_failed
          description: >-
            `revocation_pending` hingga bank mengonfirmasi bahwa persetujuan
            telah diakhiri, lalu `revoked`. `revocation_failed` dicoba lagi
            secara otomatis. Pengambilan data dari bank berhenti seketika saat
            pencabutan diminta.
        version:
          type: integer
          description: >-
            Versi persetujuan. Perpanjangan membuat versi berikutnya pada
            koneksi yang sama.
        granted_at:
          type: string
          format: date-time
          nullable: true
        expires_at:
          type: string
          description: >-
            Kapan persetujuan bank berakhir. Bank yang menentukannya, hingga
            `consent_days`.
          format: date-time
          nullable: true
        days_granted:
          type: integer
          description: Masa berlaku persetujuan dalam hari, sesuai yang diberikan bank.
          nullable: true
        renewed_count:
          type: integer
          description: Berapa kali persetujuan telah diperbarui.
        scopes_requested:
          type: array
          items:
            type: string
            enum:
              - accounts
              - balances
              - transactions
        scopes_granted:
          type: array
          items:
            type: string
            enum:
              - accounts
              - balances
              - transactions
        accounts_granted:
          type: array
          items:
            type: string
            format: uuid
          description: ID akun yang dibagikan oleh pengguna.
        renewal_action:
          type: string
          enum:
            - reconfirm
            - bank_auth
            - null
          description: >-
            Cara pembaruan persetujuan berlangsung: `reconfirm` berarti orang
            tersebut mengonfirmasi di layar Didit tanpa login bank, jika bank
            dan aturan negara mengizinkannya. `bank_auth` adalah login bank.
          nullable: true
        renew_by:
          type: string
          description: >-
            Berakhirnya persetujuan: perbarui sebelum waktu tersebut agar tidak
            ada celah.
          format: date-time
          nullable: true
        reconfirm_by:
          type: string
          description: >-
            Diisi ketika `renewal_action` bernilai `reconfirm`: waktu terakhir
            untuk mengonfirmasi ulang.
          format: date-time
          nullable: true
        renewable_until:
          type: string
          description: >-
            Waktu terakhir koneksi yang sama masih dapat diaktifkan kembali
            setelah persetujuan berakhir. Setelah itu, orang tersebut harus
            terhubung lagi. Nilainya sama dengan `retain_until`.
          format: date-time
          nullable: true
        retain_until:
          type: string
          description: >-
            Diisi setelah akses berakhir: berapa lama data yang tersimpan tetap
            dapat dibaca, ditetapkan oleh pengaturan retensi aplikasi Anda.
          format: date-time
          nullable: true
        ended_at:
          type: string
          format: date-time
          nullable: true
        ended_by:
          type: string
          enum:
            - end_user
            - bank
            - customer
            - unknown
            - null
          description: >-
            Pihak yang mengakhiri akses, ditetapkan dari bukti. `unknown` jika
            bank maupun sinkronisasi tidak menyatakannya.
          nullable: true
      required:
        - status
        - version
        - granted_at
        - expires_at
        - days_granted
        - renewed_count
        - scopes_requested
        - scopes_granted
        - accounts_granted
        - renewal_action
        - renew_by
        - reconfirm_by
        - renewable_until
        - retain_until
        - ended_at
        - ended_by
    BankConnectionSync:
      type: object
      description: Status sinkronisasi sebuah koneksi.
      properties:
        status:
          type: string
          enum:
            - pending
            - ok
            - failing
          description: >-
            `failing` setelah 24 jam percobaan yang gagal, yang dicoba ulang
            dengan backoff. Bank yang meminta orang tersebut masuk kembali
            membuat koneksi menjadi `renewal_required`.
        initial_status:
          type: string
          enum:
            - pending
            - succeeded
            - partial
            - failed
          description: >-
            Hasil sinkronisasi pertama. Koneksi menjadi `active` saat
            `succeeded` atau `partial`, dan menjadi `failed` jika tidak ada akun
            yang berhasil.
        initial_complete:
          type: boolean
          description: >-
            `true` hanya ketika `initial_status` adalah `succeeded`: akun,
            saldo, dan transaksi terbaru dapat dibaca.
        history_complete:
          type: boolean
          description: >-
            `true` ketika pengisian riwayat berakhir, apa pun alasannya. Rentang
            yang tidak berhasil diambil ada di `history_coverage.missing_ranges`
            setiap akun.
        last_synced_at:
          type: string
          description: >-
            Kapan data terakhir diambil dari bank, bukan kapan Anda terakhir
            membacanya.
          format: date-time
          nullable: true
        next_sync_at:
          type: string
          description: >-
            Kapan sinkronisasi otomatis berikutnya dijadwalkan. Sinkronisasi
            otomatis berjalan satu hingga empat kali sehari tergantung bank
            (lihat `frequency_per_day`).
          format: date-time
          nullable: true
        budgets:
          type: array
          items:
            $ref: '#/components/schemas/BankSyncBudget'
          description: Batas bank untuk pengambilan data tanpa kehadiran orang tersebut.
        last_error:
          allOf:
            - $ref: '#/components/schemas/BankSyncError'
          nullable: true
          description: Error sinkronisasi terakhir, atau `null`.
        frequency_per_day:
          type: integer
          minimum: 1
          maximum: 4
          description: >-
            Berapa kali sehari sinkronisasi otomatis dijalankan untuk koneksi
            ini, antara satu hingga empat kali tergantung bank. Jika bank
            mengizinkan lebih banyak pembacaan tanpa pengawasan, minimal dua
            kali sehari selalu disisakan untuk sinkronisasi langsung.
        live_syncs_left_today:
          type: integer
          minimum: 0
          description: >-
            Berapa banyak sinkronisasi langsung (`refresh_connection`) yang
            tersisa hari ini dalam batas bank: `remaining` dari anggaran yang
            paling ketat. `null` jika bank tidak menetapkan batas. Sinkronisasi
            langsung sudah termasuk dalam harga bulanan.
          nullable: true
      required:
        - status
        - initial_status
        - initial_complete
        - history_complete
        - last_synced_at
        - next_sync_at
        - budgets
        - last_error
        - frequency_per_day
        - live_syncs_left_today
    BankConnectionAccountSummary:
      type: object
      description: Bentuk singkat dari akun di dalam koneksi.
      properties:
        id:
          type: string
          description: ID akun. Stabil selama masa hidup koneksi, termasuk perpanjangan.
          format: uuid
        name:
          type: string
          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: Kode mata uang ISO 4217.
        iban_last4:
          type: string
          description: Empat karakter terakhir IBAN, jika akun memilikinya.
          nullable: true
        status:
          type: string
          enum:
            - open
            - closed
            - access_removed
      required:
        - id
        - name
        - type
        - usage
        - currency
        - iban_last4
        - status
    BankConnectionOwnership:
      type: object
      description: >-
        Perbandingan opsional antara pemegang rekening dengan orang atau
        perusahaan.
      properties:
        compare:
          type: string
          enum:
            - none
            - person
            - business
        match:
          type: string
          enum:
            - any_holder
            - all_holders
            - null
          nullable: true
        check_id:
          type: string
          description: Id hasil kepemilikan jika perbandingan diminta.
          format: uuid
          nullable: true
        result:
          type: string
          enum:
            - match
            - close_match
            - no_match
            - unknown
            - null
          description: >-
            Hasil. Bernilai `unknown` setiap kali bukti pemegang rekening yang
            belum lengkap dapat mengubahnya, dan saat bank tidak membagikan
            pemegang rekening.
          nullable: true
      required:
        - compare
        - match
        - check_id
        - result
    BankConnectionBilling:
      type: object
      description: Berapa biaya koneksi ini. Sandbox tidak pernah dikenakan biaya.
      properties:
        unit:
          type: string
          description: >-
            Unit penagihan, `connection_month` untuk akses berkelanjutan,
            `one_time` untuk lainnya.
          enum:
            - connection_month
            - one_time
        price_usd:
          type: string
          description: >-
            Harga Anda untuk meteran bulanan hari ini, untuk aplikasi dan negara
            Anda, dalam USD, berupa string desimal dengan 4 angka desimal.
            Koneksi hanya ditagih untuk satu bulan jika setiap cakupan yang
            disetujui menerbitkan data untuk setidaknya satu rekening di bulan
            tersebut. `null` untuk koneksi sekali baca dan di sandbox. Akses
            berkelanjutan ditagih per koneksi aktif per bulan; harga terkini ada
            di halaman harga (https://docs.didit.me/getting-started/pricing).
            Jumlah dalam contoh bersifat ilustrasi; harga untuk suatu negara
            ditampilkan di halaman harga.
          pattern: ^-?\d+(\.\d+)?$
          nullable: true
        billed_through:
          type: string
          description: Akhir bulan terakhir yang sudah diselesaikan.
          format: date
          nullable: true
      required:
        - unit
        - price_usd
        - billed_through
    BankConnectionErasure:
      type: object
      description: Kemajuan penghapusan yang Anda minta.
      properties:
        status:
          type: string
          enum:
            - pending
            - erased
            - failed
          description: >-
            `pending` selama penghapusan berjalan, `erased` ketika tidak ada
            salinan tersimpan dan tidak ada akses di bank yang tersisa, `failed`
            ketika tidak dapat dikonfirmasi dalam 24 jam. Penghapusan yang gagal
            membuat data koneksi tetap tertutup, dicoba ulang, dan Didit diberi
            tahu.
        requested_at:
          type: string
          format: date-time
        erased_at:
          type: string
          format: date-time
          nullable: true
          description: Kapan penghapusan selesai. `null` sampai `status` bernilai `erased`.
      required:
        - status
        - requested_at
        - erased_at
    BankSyncBudget:
      type: object
      description: >-
        Satu bucket dari batas bank untuk pengambilan data tanpa kehadiran
        pengguna.
      properties:
        scope:
          type: string
          enum:
            - connection
            - account
          description: Apa yang dijadikan acuan bank untuk menghitung anggaran.
        resource:
          type: string
          enum:
            - all
            - accounts
            - balances
            - transactions
        account_id:
          type: string
          description: Rekening, jika `scope` bernilai `account`.
          format: uuid
          nullable: true
        limit:
          type: integer
          description: >-
            Berapa kali sehari Didit boleh mengambil data dari bank tanpa
            kehadiran orang tersebut, sesuai definisi bank. Ini adalah batas
            maksimum yang ditetapkan bank, bukan jaminan.
        remaining:
          type: integer
          description: >-
            Sisa pengambilan data untuk penyegaran Anda dalam jendela waktu saat
            ini. Pembacaan yang disisihkan untuk sinkronisasi otomatis sudah
            dikurangi, dan sinkronisasi otomatis tidak pernah mengambil dua
            pembacaan terakhir dalam sehari, sehingga dua penyegaran sesuai
            permintaan selalu tersedia.
        resets_at:
          type: string
          description: Kapan jendela waktu diatur ulang.
          format: date-time
      required:
        - scope
        - resource
        - limit
        - remaining
        - resets_at
    BankSyncError:
      type: object
      description: Alasan sinkronisasi gagal.
      properties:
        code:
          type: string
          description: Kode error Didit.
        message:
          type: string
          description: Penjelasan dalam bahasa sederhana.
        at:
          type: string
          description: Kapan kejadian itu terjadi. `null` pada hasil per rekening.
          format: date-time
          nullable: true
      required:
        - code
        - message
        - at
  responses:
    Unauthorized:
      description: Tidak diotorisasi
      content:
        application/json:
          examples:
            Invalid API Key:
              summary: Kunci API Tidak Valid
              value:
                detail: Invalid API Key.
    BankDataAccessDenied:
      description: >-
        Kunci API tidak memiliki izin Bank data (`bank-data`), atau, untuk data
        bank mentah di aplikasi live, pengaturan aplikasi "Bank data in the API"
        dinonaktifkan. Data bank bukan bagian dari akses penuh: kunci akses
        penuh, kunci yang dibatasi pada sumber daya lain, dan permintaan yang
        diautentikasi tanpa kunci API (client credentials, untuk data mentah)
        semuanya ditolak dengan isi respons ini, jadi buat kunci dan berikan
        izin secara eksplisit. Penolakan terjadi sebelum pencarian apa pun,
        sehingga tidak memberi tahu apakah objek itu ada.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/BankDataError'
          examples:
            Bank data not allowed:
              summary: Data bank tidak diizinkan
              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: >-
        Anggaran baca middleware terlampaui. Patuhi Retry-After sebelum mencoba
        lagi.
      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: >-
        Terjadi kesalahan di sisi Didit. Setiap error tak terduga di bawah
        `/v3/bank/` dijawab dalam format error Bank, tidak pernah berupa halaman
        HTML: sebutkan `request_id` saat menghubungi dukungan.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/BankDataError'
          examples:
            Internal error:
              summary: Kesalahan tak terduga
              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: >-
        Detik untuk menunggu, dibulatkan ke atas ke jendela berikutnya. Tersedia
        pada penolakan anggaran middleware.
      schema:
        type: integer
    BudgetXRateLimitScope:
      description: >-
        Cakupan yang anggarannya terlampaui. Tersedia pada penolakan anggaran
        middleware.
      schema:
        type: string
    BudgetXRateLimitLimit:
      description: >-
        Anggaran untuk cakupan yang terlampaui; sama dengan batas pada body.
        Hadir pada penolakan anggaran middleware.
      schema:
        type: integer
    BudgetXRateLimitRemaining:
      description: >-
        Sisa anggaran, dibatasi hingga nol; sama dengan remaining pada body. Ada
        pada penolakan anggaran middleware.
      schema:
        type: integer
    BudgetXRateLimitReset:
      description: >-
        Waktu reset dalam detik Unix; sama dengan reset di body. Tersedia pada
        penolakan anggaran middleware.
      schema:
        type: integer
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Kunci API aplikasi Anda, dari Developers -> API keys di Business
        Console. Kunci utama memiliki akses penuh. Kunci bernama dapat dibatasi:
        tanpa akses, baca, atau tulis per sumber daya, dibatasi untuk beberapa
        alur kerja atau untuk sesi yang disetujui, ke daftar alamat IP tertentu,
        dan ke tanggal kedaluwarsa. 401 berarti kunci salah, dicabut, atau
        kedaluwarsa; 403 berarti tidak ada kunci yang dikirim, kunci tidak
        memiliki akses ke sumber daya atau tindakan ini, atau permintaan berasal
        dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi
        berada di luar alur kerja atau status yang diizinkan untuk kunci
        tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF
        sebagai null, dan kunci tanpa akses tulis sesi menerima tautan dan token
        sesi sebagai null. Lihat https://docs.didit.me/console/api-keys.

````

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