> ## 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. # Inquire Bank Account Holder > Look up the account holder name for one account with a bank code and an account number. This API requires no issuer registration, no certificate, and no client reference id. For a virtual account with a fixed deposit amount, set `amount` to that amount. To look up several accounts at once, use the bulk inquiry API. [Bank account holder guide](/en/api-introduction/bank-account-holder) ## OpenAPI ````yaml /openapi.en.yaml post /v1/bankAccountHolders:inquire 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:inquire: post: tags: - Bank Account Holder summary: Inquire Bank Account Holder description: > Look up the account holder name for one account with a bank code and an account number. This API requires no issuer registration, no certificate, and no client reference id. For a virtual account with a fixed deposit amount, set `amount` to that amount. To look up several accounts at once, use the bulk inquiry API. [Bank account holder guide](/en/api-introduction/bank-account-holder) requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BankAccountHolderInquiry' examples: Without hyphens: x-parity-id: plain summary: Account number without hyphens value: bankCode: '088' accountNumber: '1000000001' With hyphens: x-parity-id: hyphenated summary: Account number with hyphens value: bankCode: '088' accountNumber: 100-0000-001 Amount-verified virtual account: x-parity-id: amount-verified summary: Send the deposit amount together value: bankCode: '089' accountNumber: '1000000004' amount: 20000 responses: '200': description: Lookup succeeded content: application/json: schema: $ref: '#/components/schemas/BankAccountHolderResponse' examples: Individual account: x-parity-id: individual summary: Individual holder value: bankCode: '088' accountNumber: '1000000001' holderName: 홍길동 Corporate account: x-parity-id: corporate summary: Corporate holder value: bankCode: '088' accountNumber: '1000000002' holderName: (주)볼타 headers: {} '400': description: > The bank could not verify the account, or the request is invalid. Use the response `code` to tell the causes apart. `ACCOUNT_NOT_VERIFIED`: The bank did not verify the account. `ACCOUNT_NOT_AVAILABLE`: The virtual account cannot accept deposits. `AMOUNT_REQUIRED`: The virtual account has a fixed deposit amount. Set `amount` and look it up again. `AMOUNT_MISMATCH`: The `amount` you sent differs from the amount fixed on the virtual account. `AMOUNT_VERIFICATION_UNAVAILABLE`: Bolta cannot look up this amount-verified virtual account right now. `UNSUPPORTED_BANK`: The bank code does not support account holder lookup. `INVALID_REQUEST`: The request format is wrong, or a test key requested an account outside the fixed list. 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`. 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: > Bolta cannot look up the account holder right now. 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: 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 BankAccountHolderResponse: type: object description: Single account holder lookup result properties: bankCode: type: string description: The bank code you sent accountNumber: type: string description: Account number with hyphens removed holderName: type: string description: Account holder name required: - bankCode - accountNumber - holderName 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. ````