> ## 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 Koneksi Bank: Persetujuan, Sinkronisasi & Akun

> Endpoint Didit Get a Bank Connection mengembalikan koneksi dengan status, tanggal persetujuan, sinkronisasi, ringkasan akun, dan biaya.

Endpoint Get a Bank Connection dari Didit mengembalikan satu koneksi beserta statusnya, tanggal persetujuan, status sinkronisasi, ringkasan rekening, dan biayanya.
`sync.initial_status` menunjukkan kapan data pertama dapat dibaca, `consent.expires_at` menunjukkan kapan Anda perlu memperbarui persetujuan, dan `sync.budgets` menunjukkan berapa kali penyegaran data masih diizinkan oleh bank.
Lihat [Koneksi](https://docs.didit.me/id/core-technology/bank-verification/connections.md).


## OpenAPI

````yaml id/openapi-25.json GET /v3/bank/connections/{id}/
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/{id}/:
    get:
      tags:
        - Bank Data
      summary: Mendapatkan koneksi bank
      description: >-
        Mengembalikan koneksi beserta persetujuan, status sinkronisasi, dan
        ringkasan setiap akun. Baca data itu sendiri dengan operasi akun, saldo,
        dan transaksi. Koneksi yang telah dihapus dikembalikan sebagai catatan
        minimal: ID-nya, `status: deleted`, alasannya, tanggalnya, dan status
        `erasure`-nya, tanpa akun, saldo, transaksi, persetujuan, atau data
        sinkronisasi.


        Memerlukan kunci API dengan izin Bank data (`bank-data`): baca untuk
        operasi ini. Kunci dengan akses penuh tidak mencakup izin ini: berikan
        secara eksplisit saat membuat kunci, atau panggilan akan mengembalikan
        `403 bank_data_access_denied`.
      operationId: getBankConnection
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: ID koneksi.
      responses:
        '200':
          description: Koneksi.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankConnection'
              examples:
                Active ongoing connection:
                  summary: Koneksi bisnis berkelanjutan yang aktif
                  value:
                    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'
                Renewal required:
                  summary: >-
                    Persetujuan telah berakhir; data tetap dapat dibaca seperti
                    pada sinkronisasi terakhir
                  value:
                    id: 5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35
                    environment: live
                    access: ongoing
                    status: renewal_required
                    status_reason: consent_expired
                    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: expired
                      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: '2027-06-19T12:04:11Z'
                      retain_until: '2027-06-19T12:04:11Z'
                      ended_at: '2027-05-20T12:04:11Z'
                      ended_by: bank
                    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'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/BankDataAccessDenied'
        '404':
          description: Sumber daya tidak ada dalam aplikasi dan lingkungan ini.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Not found:
                  summary: Tidak ditemukan
                  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
        '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/'
            \
              -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.get_connection(
                "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.getConnection("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.GetConnection(ctx, \"11111111-2222-3333-4444-555555555555\")\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().getConnection("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->getConnection('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.get_connection("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.GetConnectionAsync("11111111-2222-3333-4444-555555555555");

            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  schemas:
    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
    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
    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
    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
    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.