> ## 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. To check many numbers at once, use the bulk lookup API. [Business registration status guide](/en/docs/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/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: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.
        To check many numbers at once, use the bulk lookup API. [Business
        registration status
        guide](/en/docs/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: >-
        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.

````