> ## 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/docs/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/docs/api-introduction/overview) | [Authentication guide](/en/docs/api-introduction/authentication) | [Use cases](/en/docs/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/docs/api-introduction/issuance-guide) | [Amendment types](/en/docs/api-introduction/amendment-guide) - name: Tax Invoice Retrieval description: > Retrieve e-tax invoice results and request processing status, and download the PDF of an issued tax invoice. [Tax invoice PDF guide](/en/docs/api-introduction/tax-invoice-pdf) - name: Reverse Issuance description: > Request and manage reverse issuance of e-tax invoices. [Email-approval reverse issuance](/en/docs/api-introduction/usecase-reverse-email) | [Simple-approval reverse issuance](/en/docs/api-introduction/usecase-reverse-simple) - name: Cash Receipt description: > Issue, cancel, and check the status of cash receipts. [Cash receipt guide](/en/docs/api-introduction/cash-receipt-guide) | [Cash receipt webhooks](/en/docs/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/docs/api-introduction/business-registration-status) - name: Revenue and Expense description: > Retrieve the revenue and expense tax invoices of your own business in Bolta in the order they changed, and request a collection. Responses include documents issued through Bolta and documents collected from Hometax. You need a Standard plan or higher, and the calls deduct no points. Connect Hometax in the Bolta dashboard first. [Revenue and expense guide](/en/docs/api-introduction/revenue-expense) - 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/docs/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/docs/api-introduction/bank-account-holder) - name: Document Issuance description: > Issue National Tax Service certificates from Hometax or a certified copy of corporate registry, and download the original PDF. Hometax documents are issued only for the business that owns the API key, and you must register a joint certificate in the Bolta dashboard. A corporate registry is issued for the corporation in `corporationNumber` and needs no joint certificate. Supported corporation types are stock company, limited company, general partnership company, limited partnership company, limited liability company, incorporated association, incorporated foundation, medical corporation, cooperative (including social cooperative), and other corporate entity (such as a patent corporation). Each document deducts 500 points for Hometax documents, 1,000 points for a corporate registry view copy, and 1,500 points for a submission copy. [Document issuance guide](/en/docs/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/docs/api-introduction/glossary) | [Delegated issuance](/en/docs/api-introduction/usecase-delegated) | [Brokered Tax Invoice Issuance](/en/docs/api-introduction/usecase-brokered) - name: Certificate description: > Register and manage issuer certificates. [Certificate registration](/en/docs/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/docs/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 a fixed-amount 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. 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/docs/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 a fixed-amount 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: >- Append a colon to your API key, Base64-encode it, and put it in the header. Enter the API key as the username and leave the password empty. ````