> ## Documentation Index > Fetch the complete documentation index at: https://docs.bolta.io/llms.txt > Use this file to discover all available pages before exploring further. # List Bank Accounts > Returns the bank accounts connected to the business that owns the API key, with the sync status of each account. You cannot retrieve another business's accounts. You need a Standard plan or higher, and the call deducts no points. The API does not connect accounts, so connect them in the Bolta dashboard first. Test keys return two fixed sample accounts regardless of your subscription. [Bank account transactions guide](/en/api-introduction/bank-account-transactions) ## OpenAPI ````yaml /openapi.en.yaml get /v1/bankAccounts openapi: 3.1.0 info: title: Bolta API description: > The Bolta e-tax invoice API. [API Overview](/en/api-introduction/overview) | [Authentication guide](/en/api-introduction/authentication) | [Use cases](/en/api-introduction/usecase-b2b) version: 1.0.0 servers: - url: https://xapi.bolta.io description: Bolta API server security: - basicAuth: [] tags: - name: Tax Invoice Issuance description: > Issue and amend e-tax invoices. [Calculating the issuance amount](/en/api-introduction/issuance-guide) | [Amendment types](/en/api-introduction/amendment-guide) - name: Tax Invoice Retrieval description: Retrieve e-tax invoice results and request processing status. - name: Reverse Issuance description: > Request and manage reverse issuance of e-tax invoices. [Email-approval reverse issuance](/en/api-introduction/usecase-reverse-email) | [Simple-approval reverse issuance](/en/api-introduction/usecase-reverse-simple) - name: Cash Receipt description: > Issue, cancel, and check the status of cash receipts. Check the final result via webhook or the status API. A live request that remains in progress or needs its issuance result confirmed can be finalized after 17:00 KST on the day following the request. [Cash receipt guide](/en/api-introduction/cash-receipt-guide) | [Cash receipt webhooks](/en/api-introduction/webhook-cash-receipt) - name: Business Registration Status description: > Check the registration status and tax type of a business registration number. Look up one number or up to 100 numbers at once. This API requires no issuer registration and no certificate. [Business registration status guide](/en/api-introduction/business-registration-status) - name: Bank Account Transactions description: > Retrieve the bank accounts and transactions connected to your own business in Bolta, and request a sync. You need a Standard plan or higher, and the calls deduct no points. Connect bank accounts in the Bolta dashboard first. [Bank account transactions guide](/en/api-introduction/bank-account-transactions) - name: Issuer description: > Register and manage businesses that act as tax invoice issuers. Certificate requirements depend on the issuance type. [Glossary](/en/api-introduction/glossary) | [Delegated issuance](/en/api-introduction/usecase-delegated) | [Brokered Tax Invoice Issuance](/en/api-introduction/usecase-brokered) - name: Certificate description: > Register and manage issuer certificates. [Certificate registration](/en/api-introduction/certificate-registration) paths: /v1/bankAccounts: get: tags: - Bank Account Transactions summary: List Bank Accounts description: > Returns the bank accounts connected to the business that owns the API key, with the sync status of each account. You cannot retrieve another business's accounts. You need a Standard plan or higher, and the call deducts no points. The API does not connect accounts, so connect them in the Bolta dashboard first. Test keys return two fixed sample accounts regardless of your subscription. [Bank account transactions guide](/en/api-introduction/bank-account-transactions) responses: '200': description: Lookup succeeded content: application/json: schema: $ref: '#/components/schemas/BankAccountListResponse' examples: Test key sample accounts: x-parity-id: test-accounts summary: Fixed samples returned for test keys value: items: - id: '1' bank: KB_STAR bankName: 국민은행 accountNumber: 123456-01-234567 name: 운영자금 currencyCode: KRW lastSyncedAt: null syncStatus: IDLE - id: '2' bank: SHINHAN bankName: 신한은행 accountNumber: 110-123-456789 name: 매출입금 currencyCode: KRW lastSyncedAt: null syncStatus: IDLE Sync in progress: x-parity-id: in-progress summary: An account right after a sync request value: items: - id: '1' bank: KB_STAR bankName: 국민은행 accountNumber: 123456-01-234567 name: 운영자금 currencyCode: KRW lastSyncedAt: '2026-09-18T00:00:12Z' syncStatus: IN_PROGRESS headers: {} '401': description: API key authentication failed. The response has no body. '402': description: >- Your subscription is below the Standard plan. The response `code` is `PLAN_UPGRADE_REQUIRED`. Upgrade your plan from the billing menu in the Bolta dashboard, then call again. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: >- Internal server error. The response `code` is `INTERNAL_SERVER_ERROR`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '503': description: >- Temporary internal API communication error. The response `code` is `SERVICE_UNAVAILABLE`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' deprecated: false components: schemas: BankAccountListResponse: type: object description: Bank account list result properties: items: type: array description: Connected bank accounts. Empty when no account is connected. items: $ref: '#/components/schemas/BankAccount' required: - items ErrorResponse: type: object description: The error response returned when an API request fails properties: code: type: string description: Error type identifier message: type: string description: Error description traceId: type: string description: Request trace identifier required: - code - message - traceId BankAccount: type: object description: A bank account connected to Bolta properties: id: type: string description: >- Account identifier. Treat it as a string even if it looks numeric; the format may change. bank: type: string description: >- Bank code, such as `KB_STAR` or `SHINHAN`. New banks may be added, so display `bankName` instead. examples: - KB_STAR bankName: type: string description: Bank name accountNumber: type: string description: Account number with hyphens name: type: string description: Alias set in the dashboard. Falls back to the bank's account name. currencyCode: type: string description: Currency code examples: - KRW lastSyncedAt: type: - string - 'null' format: date-time description: >- Time of the last completed sync (UTC). `null` when no sync has completed yet. syncStatus: $ref: '#/components/schemas/BankAccountSyncStatus' required: - id - bank - bankName - accountNumber - name - currencyCode - lastSyncedAt - syncStatus BankAccountSyncStatus: type: string enum: - IDLE - IN_PROGRESS - FAILED description: > Account sync status. `IDLE`: No sync is running. `IN_PROGRESS`: A bank lookup is running. `FAILED`: The last sync failed. securitySchemes: basicAuth: type: http scheme: basic description: >- Base64-encode your API key and pass it. Enter the API key as the username and leave the password empty. ````