> ## 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 Status > Check the registration status and tax type of a single business registration number. This API requires no issuer registration, no certificate, and no client reference ID. A test key returns mock data for the fixed numbers listed in the guide. Bolta provides no idempotency key. To check many numbers at once, use the bulk lookup API. [Business registration status guide](/en/api-introduction/business-registration-status) ## OpenAPI ````yaml /openapi.en.yaml post /v1/businessRegistrationStatuses:check 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:check: post: tags: - Business Registration Status summary: Check Business Registration Status description: > Check the registration status and tax type of a single business registration number. This API requires no issuer registration, no certificate, and no client reference ID. A test key returns mock data for the fixed numbers listed in the guide. Bolta provides no idempotency key. To check many numbers at once, use the bulk lookup API. [Business registration status guide](/en/api-introduction/business-registration-status) requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BusinessRegistrationStatusCheckRequest' examples: Without hyphens: x-parity-id: plain summary: Ten digits without hyphens value: businessRegistrationNumber: '1000000014' With hyphens: x-parity-id: hyphenated summary: Number that includes hyphens value: businessRegistrationNumber: 100-00-00014 responses: '200': description: Lookup succeeded content: application/json: schema: $ref: '#/components/schemas/BusinessRegistrationStatusResponse' examples: Active business: x-parity-id: active summary: Active business value: businessRegistrationNumber: '1000000014' registration: status: ACTIVE closedOn: null taxType: GENERAL Suspended business: x-parity-id: suspended summary: Suspended business value: businessRegistrationNumber: '1000000066' registration: status: SUSPENDED closedOn: null taxType: null Closed business: x-parity-id: closed summary: Closed business value: businessRegistrationNumber: '1000000071' registration: status: CLOSED closedOn: '2026-01-01' taxType: null headers: {} '400': description: > The business registration number is missing or is not ten digits. A test key that looks up a number outside the guide returns the same response. The response `code` is `INVALID_REQUEST`. When the 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 or Bolta's service-wide daily lookup limit is exhausted. 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 cannot check the business registration status right now. 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: BusinessRegistrationStatusCheckRequest: type: object description: Business registration status check request properties: businessRegistrationNumber: $ref: '#/components/schemas/BusinessRegistrationStatusQueryNumber' required: - businessRegistrationNumber 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 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 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. ````