> ## 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. # Request Bank Account Sync > Requests a bank lookup for every connected bank account. The API only accepts the request with `202 Accepted`, and the bank lookup runs asynchronously. Bolta fetches transactions periodically, so request a sync only when you need the latest transactions sooner. Check progress with `syncStatus` in the account list. When `IN_PROGRESS` ends, continue fetching transactions with your saved cursor. Each business can request a sync once every 30 minutes and up to 12 times in 24 hours. A request rejected because a sync is already running (`409`) does not count toward the limit. Test keys send no bank lookup, use no quota, and return only the acceptance response. [Bank account transactions guide](/en/api-introduction/bank-account-transactions) ## OpenAPI ````yaml /openapi.en.yaml post /v1/bankAccounts:sync 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:sync: post: tags: - Bank Account Transactions summary: Request Bank Account Sync description: > Requests a bank lookup for every connected bank account. The API only accepts the request with `202 Accepted`, and the bank lookup runs asynchronously. Bolta fetches transactions periodically, so request a sync only when you need the latest transactions sooner. Check progress with `syncStatus` in the account list. When `IN_PROGRESS` ends, continue fetching transactions with your saved cursor. Each business can request a sync once every 30 minutes and up to 12 times in 24 hours. A request rejected because a sync is already running (`409`) does not count toward the limit. Test keys send no bank lookup, use no quota, and return only the acceptance response. [Bank account transactions guide](/en/api-introduction/bank-account-transactions) responses: '202': description: Request accepted content: application/json: schema: $ref: '#/components/schemas/BankAccountSyncResponse' examples: Accepted: x-parity-id: accepted summary: >- Accepted response; the next request is allowed 30 minutes later value: acceptedAt: '2026-09-18T03:00:00Z' nextAvailableAt: '2026-09-18T03:30:00Z' 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' '409': description: >- A sync is already running. The response `code` is `SYNC_IN_PROGRESS`. This request does not count toward the limit, so request again after the sync ends. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: >- No bank account is connected. The response `code` is `BANK_ACCOUNT_NOT_CONNECTED`. Connect an account in the Bolta dashboard first. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: >- The request exceeds the 30-minute interval or the 12-per-24-hours limit. The response `code` is `SYNC_RATE_LIMITED`. Retry after the `Retry-After` interval. headers: Retry-After: description: Seconds remaining until you can retry schema: type: integer 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: > Bolta cannot evaluate the sync request right now. The response `code` is `SYNC_UNAVAILABLE`. Request again shortly. A temporary internal API communication error returns `SERVICE_UNAVAILABLE`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' deprecated: false components: schemas: BankAccountSyncResponse: type: object description: Sync request acceptance result properties: acceptedAt: type: string format: date-time description: Time the request was accepted (UTC) nextAvailableAt: type: string format: date-time description: >- Earliest time the next request clears the 30-minute interval (UTC). Does not reflect the 12-per-24-hours limit. required: - acceptedAt - nextAvailableAt 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 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. ````