> ## 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. 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/docs/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/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/businessRegistrationStatuses:checkBulk: post: tags: - Business Registration Status summary: Check Business Registration Statuses in Bulk description: > Check up to 100 business registration numbers at once. 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/docs/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: >- 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. ````