> ## 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. # Check Business Registration Statuses in Bulk > Check up to 100 business registration numbers at once. Each result has the same structure as the single lookup response. This API requires no issuer registration, no certificate, and no client reference ID. The API keeps only the first occurrence of a duplicate number and returns `results` in request order. A number the API could not check in this request has `status: null`, so retry only that number after a short wait. If no number can be checked, the API returns `503`. A test key returns mock data only for the fixed numbers listed in the guide and rejects the whole request if any other number is included. [Business registration status guide](/en/api-introduction/business-registration-status) ## OpenAPI ````yaml /openapi.en.yaml post /v1/businessRegistrationStatuses:checkBulk 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: 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/businessRegistrationStatuses:checkBulk: post: tags: - Business Registration Status summary: Check Business Registration Statuses in Bulk description: > Check up to 100 business registration numbers at once. Each result has the same structure as the single lookup response. This API requires no issuer registration, no certificate, and no client reference ID. The API keeps only the first occurrence of a duplicate number and returns `results` in request order. A number the API could not check in this request has `status: null`, so retry only that number after a short wait. If no number can be checked, the API returns `503`. A test key returns mock data only for the fixed numbers listed in the guide and rejects the whole request if any other number is included. [Business registration status guide](/en/api-introduction/business-registration-status) requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BusinessRegistrationStatusBulkCheckRequest' examples: Multiple numbers: x-parity-id: multiple summary: Numbers with and without hyphens value: businessRegistrationNumbers: - '1000000014' - 100-00-00028 - '1000000066' responses: '200': description: Lookup succeeded. At least one number was checked. content: application/json: schema: $ref: '#/components/schemas/BusinessRegistrationStatusBulkResponse' examples: All checked: x-parity-id: all-resolved summary: Every number was checked value: results: - businessRegistrationNumber: '1000000014' status: businessRegistrationNumber: '1000000014' registration: status: ACTIVE closedOn: null taxType: GENERAL - businessRegistrationNumber: '1000000028' status: businessRegistrationNumber: '1000000028' registration: status: ACTIVE closedOn: null taxType: SIMPLIFIED - businessRegistrationNumber: '1000000066' status: businessRegistrationNumber: '1000000066' registration: status: SUSPENDED closedOn: null taxType: null Partially checked: x-parity-id: partially-resolved summary: >- Some numbers could not be checked with a live key. The numbers are format examples value: results: - businessRegistrationNumber: '1000000014' status: businessRegistrationNumber: '1000000014' registration: status: ACTIVE closedOn: null taxType: GENERAL - businessRegistrationNumber: '1000000028' status: null - businessRegistrationNumber: '1000000066' status: businessRegistrationNumber: '1000000066' registration: status: SUSPENDED closedOn: null taxType: null headers: {} '400': description: > The number list is missing, empty, or longer than 100. The same response applies when any item is not ten digits or when a test key includes a number outside the guide. The response `code` is `INVALID_REQUEST`. When an item's checksum does not match, the `code` is `INVALID_BUSINESS_REGISTRATION_NUMBER`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: API key authentication failed. The response has no body. '402': description: >- The live key has an insufficient balance. The response `code` is `PAYMENT_REQUIRED`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: >- The client does not have access to the requested resource. The response `code` is `FORBIDDEN`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: >- The partner call quota is insufficient, or Bolta's service-wide daily lookup limit was reached before any number could be checked. The quota counts numbers checked. The response `code` is `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 could not check the business registration status of any number. The response `code` is `LOOKUP_UNAVAILABLE`. A temporary internal API communication error returns `SERVICE_UNAVAILABLE`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' deprecated: false components: schemas: BusinessRegistrationStatusBulkCheckRequest: type: object description: Business registration status bulk check request properties: businessRegistrationNumbers: type: array description: >- Business registration numbers to check. Enter between 1 and 100. Only the first occurrence of a duplicate is kept. minItems: 1 maxItems: 100 items: $ref: '#/components/schemas/BusinessRegistrationStatusQueryNumber' required: - businessRegistrationNumbers BusinessRegistrationStatusBulkResponse: type: object description: Business registration status bulk lookup result properties: results: type: array description: >- One item per requested number, in request order after duplicates are removed. items: $ref: '#/components/schemas/BusinessRegistrationStatusBulkItem' 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 BusinessRegistrationStatusQueryNumber: type: string title: Business registration number to check description: >- Ten-digit business registration number to check. Hyphens are allowed. The response returns ten digits with hyphens removed. The examples are test-key-only fixed numbers. pattern: ^\d{3}-?\d{2}-?\d{5}$ examples: - '1000000014' - 100-00-00014 BusinessRegistrationStatusBulkItem: type: object description: Per-number result of a bulk lookup properties: businessRegistrationNumber: type: string description: Ten-digit business registration number with hyphens removed pattern: ^\d{10}$ status: description: >- Same structure as the single lookup response. `null` if the number could not be checked in this request. oneOf: - $ref: '#/components/schemas/BusinessRegistrationStatusResponse' - type: 'null' required: - businessRegistrationNumber - status BusinessRegistrationStatusResponse: type: object description: >- Business registration status result. All three fields are always present, and a missing value is `null`. properties: businessRegistrationNumber: type: string description: Ten-digit business registration number with hyphens removed pattern: ^\d{10}$ registration: $ref: '#/components/schemas/BusinessRegistrationStatusRegistration' taxType: $ref: '#/components/schemas/BusinessRegistrationStatusTaxType' required: - businessRegistrationNumber - registration - taxType BusinessRegistrationStatusRegistration: type: object description: Business registration state properties: status: $ref: '#/components/schemas/BusinessRegistrationStatusRegistrationState' closedOn: type: - string - 'null' format: date description: Closing date. This is `null` unless the business is closed. required: - status - closedOn BusinessRegistrationStatusTaxType: type: - string - 'null' title: Tax type description: >- `GENERAL` general taxpayer, `SIMPLIFIED` simplified taxpayer, `TAX_FREE` tax-exempt business, `NONPROFIT` nonprofit, `OTHER_CORPORATION` other corporation. Only an active business carries a value; the others are `null`. enum: - GENERAL - SIMPLIFIED - TAX_FREE - NONPROFIT - OTHER_CORPORATION - null BusinessRegistrationStatusRegistrationState: type: string title: Business registration state description: >- `ACTIVE` active business, `SUSPENDED` suspended business, `CLOSED` closed business, `NOT_REGISTERED` unregistered number, `UNKNOWN` any other registration state. A communication failure returns `503`, not `UNKNOWN`. enum: - ACTIVE - SUSPENDED - CLOSED - NOT_REGISTERED - UNKNOWN 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. ````