> ## 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. # Bulk Inquire Bank Account Holders > Look up the account holder names for 1 to 100 accounts at once. The API returns one result per account in the order you sent them. An account with no holder has `holderName` set to `null` and the cause in `error`. If no account is verified at all, the API returns `503` instead of this response. [Bank account holder guide](/en/api-introduction/bank-account-holder) ## OpenAPI ````yaml /openapi.en.yaml post /v1/bankAccountHolders:bulkInquire 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. [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: Bank Account Holder description: > Look up account holder names with a bank code and an account number. One path takes a single account and the other takes up to 100 accounts at once. Each account that returns a holder name deducts 50 points. [Bank account holder guide](/en/api-introduction/bank-account-holder) - name: Document Issuance description: > Issue National Tax Service certificates from Hometax and download the original PDF. You can issue documents only for the business that owns the API key, and you must register a joint certificate in the Bolta dashboard. Each document deducts 500 points. [Document issuance guide](/en/api-introduction/document-issuance) - 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/bankAccountHolders:bulkInquire: post: tags: - Bank Account Holder summary: Bulk Inquire Bank Account Holders description: > Look up the account holder names for 1 to 100 accounts at once. The API returns one result per account in the order you sent them. An account with no holder has `holderName` set to `null` and the cause in `error`. If no account is verified at all, the API returns `503` instead of this response. [Bank account holder guide](/en/api-introduction/bank-account-holder) requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BankAccountHolderBulkInquiryRequest' examples: Two accounts: x-parity-id: bulk summary: A regular account and an amount-verified virtual account value: accounts: - bankCode: '088' accountNumber: '1000000001' - bankCode: '089' accountNumber: '1000000004' responses: '200': description: One result per account, in the order you sent them. content: application/json: schema: $ref: '#/components/schemas/BankAccountHolderBulkResponse' examples: Partial failure: x-parity-id: bulk-partial summary: One account found, one failed value: results: - bankCode: '088' accountNumber: '1000000001' holderName: 홍길동 error: null - bankCode: '089' accountNumber: '1000000004' holderName: null error: code: AMOUNT_REQUIRED message: 입금 금액이 정해진 가상계좌입니다. 총 지급 금액을 입력한 뒤 예금주를 다시 조회해 주세요. headers: {} '400': description: > The request is invalid. The response `code` is `INVALID_REQUEST`. The API rejects the whole request when `accounts` is empty, holds more than 100 items, or any item has an invalid format. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: API key authentication failed. The response has no body. '402': description: >- The point balance is insufficient. The response `code` is `PAYMENT_REQUIRED`. Top up in the developer center. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: >- You do not have access to the requested resource. The response `code` is `FORBIDDEN`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: >- Counting the points that in-flight requests hold, the balance is insufficient. The response `code` is `POINT_RESERVED_BY_IN_FLIGHT_REQUESTS`. Top up, or request again after the in-flight requests finish. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: >- You reached the daily lookup limit. The response `code` is `RATE_LIMITED`. Bolta counts the limit by accounts looked up, not by requests. Try again after `Retry-After`. headers: Retry-After: description: Seconds 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: > The bank verified no account at all. Use the response `code` to tell the causes apart. `BANK_UNAVAILABLE`: Bank maintenance or a connection error. Try again shortly. `LOOKUP_UNAVAILABLE`: Bolta cannot evaluate the lookup protection limit. `SERVICE_UNAVAILABLE`: A temporary internal API communication error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' deprecated: false components: schemas: BankAccountHolderBulkInquiryRequest: type: object description: Bulk account holder inquiry request properties: accounts: type: array minItems: 1 maxItems: 100 description: Accounts to look up. Send 1 to 100 accounts. items: $ref: '#/components/schemas/BankAccountHolderInquiry' required: - accounts BankAccountHolderBulkResponse: type: object description: Bulk account holder lookup result properties: results: type: array minItems: 1 maxItems: 100 description: One item per requested account, in the order you sent them. items: $ref: '#/components/schemas/BankAccountHolderBulkItem' required: - results 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 BankAccountHolderInquiry: type: object description: An account to look up properties: bankCode: type: string pattern: ^\d{3}$ description: >- Three-digit KFTC standard bank code. See the [bank account holder guide](/en/api-introduction/bank-account-holder) for supported banks. examples: - '088' accountNumber: type: string pattern: ^-*(?:\d-*){6,20}$ description: >- Account number. Hyphens are allowed. Without hyphens it must be 6 to 20 digits. examples: - '1000000001' amount: type: integer format: int64 minimum: 1 description: >- Deposit amount in KRW for an amount-verified virtual account. Leave it empty for a regular account. required: - bankCode - accountNumber BankAccountHolderBulkItem: type: object description: Lookup result for one account oneOf: - properties: holderName: type: string error: type: 'null' - properties: holderName: type: 'null' error: $ref: '#/components/schemas/BankAccountHolderInquiryError' properties: bankCode: type: string description: The bank code you sent accountNumber: type: string description: Account number with hyphens removed holderName: type: - string - 'null' description: Account holder name. It is `null` when no holder was found. error: description: >- Why the lookup found no holder. It is `null` when the lookup succeeded. anyOf: - $ref: '#/components/schemas/BankAccountHolderInquiryError' - type: 'null' required: - bankCode - accountNumber - holderName - error BankAccountHolderInquiryError: type: object description: >- Why one bulk item failed. It uses the same `code` vocabulary as the single inquiry. properties: code: type: string enum: - ACCOUNT_NOT_VERIFIED - ACCOUNT_NOT_AVAILABLE - AMOUNT_REQUIRED - AMOUNT_MISMATCH - AMOUNT_VERIFICATION_UNAVAILABLE - UNSUPPORTED_BANK - BANK_UNAVAILABLE - LOOKUP_UNAVAILABLE - SERVICE_UNAVAILABLE - PAYMENT_REQUIRED - POINT_RESERVED_BY_IN_FLIGHT_REQUESTS - RATE_LIMITED - FORBIDDEN - INVALID_REQUEST description: Error type identifier message: type: string description: Error description. The API returns it as a Korean sentence. required: - code - message 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. ````