> ## 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. # Retrieve Business Profile > Retrieve the detailed profile of one business registration number. This API requires no issuer registration, no certificate, and no client reference id. A successful retrieval deducts 90 points, and a number with no profile (`404`) deducts nothing. `registration` and `taxation` hold the values Bolta last checked and stored. When you need the state at call time, use the Business Registration Status API. A test key returns mock results only for the test numbers listed in the guide. [Business profile guide](/en/docs/api-introduction/business-profile) ## OpenAPI ````yaml /openapi.en.yaml get /v1/businessProfiles/{businessRegistrationNumber} 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. Each number whose status the API returns deducts 10 points. [Business registration status guide](/en/docs/api-introduction/business-registration-status) - name: Business Registration Certificate Extraction and Verification description: > Reads the business registration number, business name, representative names, opening date, address, and industries from a business registration certificate file, and returns the NTS verification result. This API requires no issuer registration and no certificate. Each document whose verification result is `MATCHED` or `NOT_MATCHED` deducts 100 points. [Business registration certificate extraction and verification guide](/en/docs/api-introduction/business-registration-certificate) - name: Business Profile description: > Search for businesses by business name, representative name, or business registration number, and retrieve the detailed profile of one business registration number. This API requires no issuer registration and no certificate. Search deducts 9 points for each result returned, and profile retrieval deducts 90 points for each successful retrieval. [Business profile guide](/en/docs/api-introduction/business-profile) - 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/businessProfiles/{businessRegistrationNumber}: get: tags: - Business Profile summary: Retrieve Business Profile description: > Retrieve the detailed profile of one business registration number. This API requires no issuer registration, no certificate, and no client reference id. A successful retrieval deducts 90 points, and a number with no profile (`404`) deducts nothing. `registration` and `taxation` hold the values Bolta last checked and stored. When you need the state at call time, use the Business Registration Status API. A test key returns mock results only for the test numbers listed in the guide. [Business profile guide](/en/docs/api-introduction/business-profile) parameters: - name: businessRegistrationNumber in: path description: >- Ten-digit business registration number to retrieve. Hyphens are allowed. required: true schema: type: string responses: '200': description: Retrieval succeeded content: application/json: schema: $ref: '#/components/schemas/BusinessProfileResponse' examples: Corporation: x-parity-id: corporate summary: >- Result of retrieving 1000000014 with a test key. Example with every field filled value: businessRegistrationNumber: '1000000014' corporateRegistrationNumber: '1101110000006' businessKind: CORPORATE commercialSalesNumber: 2021-서울강남-01234 organizationName: 테스트상사 주식회사 organizationNameEnglish: Test Sangsa Co., Ltd. formerOrganizationNames: - name: 주식회사 테스트랩스 changedOn: '2022-03-01' representativeName: 김볼타 address: roadAddress: 서울특별시 강남구 가상로 1 postalCode: '06236' sidoCode: '11' sigunguCode: '11680' contact: phone: 02-000-0000 email: hello@example.com websites: - https://example.com industry: businessType: 서비스업 businessItem: 응용 소프트웨어 개발 standardIndustry: code: '58222' name: 응용 소프트웨어 개발 및 공급업 category: code: J name: 정보통신업 openedOn: '2021-03-02' businessRegisteredOn: '2021-03-02' corporationEstablishedOn: '2021-02-25' registration: status: ACTIVE closedOn: null checkedAt: '2025-12-31T15:00:00Z' taxation: type: GENERAL Sole proprietor: x-parity-id: individual summary: >- Result of retrieving 1000000028 with a test key. Example without corporation-only values and contact details value: businessRegistrationNumber: '1000000028' corporateRegistrationNumber: null businessKind: INDIVIDUAL commercialSalesNumber: null organizationName: 테스트상사 간이점 organizationNameEnglish: null formerOrganizationNames: [] representativeName: 이테스 address: roadAddress: 서울특별시 마포구 가상로 1 postalCode: '04100' sidoCode: '11' sigunguCode: '11440' contact: phone: null email: null websites: [] industry: businessType: 서비스업 businessItem: 응용 소프트웨어 개발 standardIndustry: code: '58222' name: 응용 소프트웨어 개발 및 공급업 category: code: J name: 정보통신업 openedOn: '2021-03-02' businessRegisteredOn: '2021-03-02' corporationEstablishedOn: null registration: status: ACTIVE closedOn: null checkedAt: '2025-12-31T15:00:00Z' taxation: type: SIMPLIFIED_RECEIPT_ISSUER Business whose state was never checked: x-parity-id: never-checked summary: >- Result of retrieving 1000000111 with a test key. Example with a null address, registration state, and taxation information value: businessRegistrationNumber: '1000000111' corporateRegistrationNumber: null businessKind: INDIVIDUAL commercialSalesNumber: null organizationName: 테스트상사 신규점 organizationNameEnglish: null formerOrganizationNames: [] representativeName: 한모의 address: null contact: phone: null email: null websites: [] industry: businessType: 서비스업 businessItem: 응용 소프트웨어 개발 standardIndustry: code: '58222' name: 응용 소프트웨어 개발 및 공급업 category: code: J name: 정보통신업 openedOn: '2021-03-02' businessRegisteredOn: '2021-03-02' corporationEstablishedOn: null registration: null taxation: null headers: {} '400': description: > The business registration number is not ten digits. The API returns the same response when you retrieve a number outside the guide's list with a test key. In these cases 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 point balance is insufficient. The response `code` is `PAYMENT_REQUIRED`. Top up in the developer center. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: >- Bolta has no profile for the number. The response `code` is `NOT_FOUND`. The API deducts no points. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: >- Not enough points are available right now because other requests are in progress. The response `code` is `AVAILABLE_POINTS_INSUFFICIENT`. Top up, or request again after those requests finish. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: >- You exceeded the rate limit of 300 calls per minute. The response `code` is `RATE_LIMITED`. Retry 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: > Retrieval is unavailable right now. The response `code` is `LOOKUP_UNAVAILABLE`. Retry later. For a temporary internal API communication error, the `code` is `SERVICE_UNAVAILABLE`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' deprecated: false components: schemas: BusinessProfileResponse: type: object description: >- One business profile. The response always contains every field. A missing value is `null`, and a list is empty. properties: businessRegistrationNumber: type: string description: Ten-digit business registration number without hyphens corporateRegistrationNumber: type: - string - 'null' description: Thirteen-digit corporation registration number without hyphens businessKind: type: - string - 'null' enum: - INDIVIDUAL - CORPORATE - null description: >- Business kind. `INDIVIDUAL` sole proprietor, `CORPORATE` corporation. commercialSalesNumber: type: - string - 'null' description: Mail-order business report number organizationName: type: - string - 'null' description: Business name organizationNameEnglish: type: - string - 'null' description: English business name formerOrganizationNames: type: array description: Former business names, most recently changed first. items: $ref: '#/components/schemas/BusinessProfileFormerOrganizationName' representativeName: type: - string - 'null' description: Representative name. A value the source masked stays masked. address: description: Address. `null` when the source has no address. oneOf: - $ref: '#/components/schemas/BusinessProfileAddress' - type: 'null' contact: $ref: '#/components/schemas/BusinessProfileContact' industry: $ref: '#/components/schemas/BusinessProfileIndustry' openedOn: type: - string - 'null' format: date description: Opening date businessRegisteredOn: type: - string - 'null' format: date description: Business registration date corporationEstablishedOn: type: - string - 'null' format: date description: Corporation establishment date registration: description: >- Business registration state Bolta last checked. `null` if Bolta has never checked it. oneOf: - $ref: '#/components/schemas/BusinessProfileRegistration' - type: 'null' taxation: description: Taxation information Bolta last checked. `null` when unknown. oneOf: - $ref: '#/components/schemas/BusinessProfileTaxation' - type: 'null' required: - businessRegistrationNumber - corporateRegistrationNumber - businessKind - commercialSalesNumber - organizationName - organizationNameEnglish - formerOrganizationNames - representativeName - address - contact - industry - openedOn - businessRegisteredOn - corporationEstablishedOn - registration - taxation 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 BusinessProfileFormerOrganizationName: type: object description: One former business name properties: name: type: string description: Former business name changedOn: type: - string - 'null' format: date description: >- Date the new business name first appeared in public filings. It can differ from the registration date of the change. required: - name - changedOn BusinessProfileAddress: type: object description: Address properties: roadAddress: type: - string - 'null' description: Road name address postalCode: type: - string - 'null' description: Five-digit postal code sidoCode: type: - string - 'null' description: Two-digit legal district code of the province sigunguCode: type: - string - 'null' description: Five-digit legal district code of the district required: - roadAddress - postalCode - sidoCode - sigunguCode BusinessProfileContact: type: object description: >- Contact details. The response holds this object even when there are no contact details. properties: phone: type: - string - 'null' description: Main phone number, formatted with hyphens. email: type: - string - 'null' description: Main email address websites: type: array description: Website URLs items: type: string required: - phone - email - websites BusinessProfileIndustry: type: object description: >- Industry. The response holds this object even when the industry is unknown. properties: businessType: type: - string - 'null' description: Business type as registered with the NTS. businessItem: type: - string - 'null' description: Business item as registered with the NTS. standardIndustry: description: >- Korean Standard Industrial Classification (11th revision) sub-subclass. The code has five digits. oneOf: - $ref: '#/components/schemas/BusinessProfileIndustryClassification' - type: 'null' category: description: >- Korean Standard Industrial Classification section. The code runs from `A` to `U`. oneOf: - $ref: '#/components/schemas/BusinessProfileIndustryClassification' - type: 'null' required: - businessType - businessItem - standardIndustry - category BusinessProfileRegistration: 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. checkedAt: type: string format: date-time description: Time Bolta checked with the NTS (UTC) required: - status - closedOn - checkedAt BusinessProfileTaxation: type: object description: Taxation information properties: type: $ref: '#/components/schemas/BusinessRegistrationStatusTaxationType' required: - type BusinessProfileIndustryClassification: type: object description: Korean Standard Industrial Classification code and name properties: code: type: string description: Classification code name: type: string description: Classification name required: - code - name 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 BusinessRegistrationStatusTaxationType: type: string title: Tax type description: >- NTS tax type. `GENERAL` general taxpayer, `SIMPLIFIED_RECEIPT_ISSUER` simplified taxpayer that cannot issue tax invoices, `SIMPLIFIED_TAX_INVOICE_ISSUER` simplified taxpayer that can issue tax invoices, `SPECIAL_TAXPAYER` special taxpayer, `TAX_FREE` tax-exempt business, `NONPROFIT` nonprofit corporation with no profit-making business or an organization with a unique identification number, `UNIQUE_NUMBER_ORGANIZATION` organization with a unique identification number. Treat any value you do not recognize as other. enum: - GENERAL - SIMPLIFIED_RECEIPT_ISSUER - SIMPLIFIED_TAX_INVOICE_ISSUER - SPECIAL_TAXPAYER - TAX_FREE - NONPROFIT - UNIQUE_NUMBER_ORGANIZATION 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. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.