> ## 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. # 사업자 프로필 상세 조회 > 사업자등록번호 한 건의 상세 프로필을 조회합니다. 발급자 등록과 공동인증서가 필요 없고, 요청자 관리번호도 쓰지 않습니다. 조회에 성공하면 90포인트를 차감하고, 프로필이 없는 번호(`404`)는 차감하지 않습니다. `registration`과 `taxation`은 볼타가 마지막으로 확인해 저장한 값입니다. 호출 시점의 상태가 필요하면 사업자등록 상태 조회 API를 쓰세요. 테스트 키는 가이드에 안내한 테스트 번호만 모의 조회합니다. [사업자 프로필 조회 가이드](/docs/api-introduction/business-profile) ## OpenAPI ````yaml /openapi.yaml get /v1/businessProfiles/{businessRegistrationNumber} openapi: 3.1.0 info: title: 볼타 API description: > 볼타 전자세금계산서 API입니다. [API 소개](/docs/api-introduction/overview) | [인증 가이드](/docs/api-introduction/authentication) | [사용 사례](/docs/api-introduction/usecase-b2b) version: 1.0.0 servers: - url: https://xapi.bolta.io description: 볼타 API 서버 security: - basicAuth: [] tags: - name: 세금계산서 발행 description: > 전자(세금)계산서를 정발행하거나 수정발행합니다. [발행 금액 계산](/docs/api-introduction/issuance-guide) | [수정발행 유형](/docs/api-introduction/amendment-guide) - name: 세금계산서 조회 description: > 전자(세금)계산서의 발행 결과와 요청 처리 상태를 조회하고, 발행 완료한 세금계산서의 PDF를 내려받습니다. [세금계산서 PDF 조회 가이드](/docs/api-introduction/tax-invoice-pdf) - name: 세금계산서 역발행 description: > 전자(세금)계산서 역발행 요청 및 관리. [이메일 승인 역발행](/docs/api-introduction/usecase-reverse-email) | [간편 승인 역발행](/docs/api-introduction/usecase-reverse-simple) - name: 현금영수증 description: > 현금영수증을 발행하거나 취소하고 처리 상태를 조회합니다. [현금영수증 발행 가이드](/docs/api-introduction/cash-receipt-guide) | [현금영수증 웹훅](/docs/api-introduction/webhook-cash-receipt) - name: 사업자등록 상태 조회 description: > 사업자등록번호의 등록 상태와 과세유형을 단건 또는 최대 100건 일괄로 조회합니다. 발급자 등록과 공동인증서가 필요 없습니다. 상태를 확인한 번호마다 10포인트를 차감합니다. [사업자등록 상태 조회 가이드](/docs/api-introduction/business-registration-status) - name: 사업자등록증 인식과 진위확인 description: > 사업자등록증 파일에서 사업자등록번호, 상호, 대표자명, 개업일, 주소, 업종을 읽고 국세청 진위확인 결과를 함께 돌려줍니다. 발급자 등록과 공동인증서가 필요 없습니다. 진위확인 결과가 `MATCHED`나 `NOT_MATCHED`인 문서마다 100포인트를 차감합니다. [사업자등록증 인식과 진위확인 가이드](/docs/api-introduction/business-registration-certificate) - name: 사업자 프로필 조회 description: > 상호, 대표자명, 사업자등록번호로 사업자를 검색하고 사업자등록번호 한 건의 상세 프로필을 조회합니다. 발급자 등록과 공동인증서가 필요 없습니다. 검색은 돌려준 결과 한 건마다 9포인트, 상세 조회는 조회 성공마다 90포인트를 차감합니다. [사업자 프로필 조회 가이드](/docs/api-introduction/business-profile) - name: 매출/매입 내역 조회 description: > 볼타에 쌓인 내 사업자의 매출과 매입 세금계산서를 바뀐 순서로 조회하고 수집을 요청합니다. 볼타에서 발행한 문서와 홈택스에서 수집한 문서가 모두 실립니다. 스탠다드 플랜 이상을 구독해야 하며 포인트는 차감하지 않습니다. 홈택스 연동은 볼타 대시보드에서 먼저 하세요. [매출/매입 내역 조회 가이드](/docs/api-introduction/revenue-expense) - name: 입출금 내역 조회 description: > 볼타에 연결한 내 사업자의 입출금 계좌와 입출금 내역을 조회하고 동기화를 요청합니다. 스탠다드 플랜 이상을 구독해야 하며 포인트는 차감하지 않습니다. 계좌는 볼타 대시보드에서 먼저 연결하세요. [입출금 내역 조회 가이드](/docs/api-introduction/bank-account-transactions) - name: 예금주 조회 description: > 은행코드와 계좌번호로 예금주명을 조회합니다. 한 계좌씩 묻는 경로와 최대 100개를 한 번에 묻는 경로가 있습니다. 예금주를 돌려준 계좌마다 50포인트를 차감합니다. [예금주 조회 가이드](/docs/api-introduction/bank-account-holder) - name: 서류 발급 description: > 홈택스 국세 증명 서류와 법인등기사항전부증명서를 발급하고 원본 PDF를 내려받습니다. 홈택스 서류는 API 키가 속한 사업자의 서류만 발급하며, 볼타 대시보드에 공동인증서를 등록해야 합니다. 법인등기는 `corporationNumber`의 법인 등기부를 발급하고 공동인증서가 필요 없습니다. 지원하는 법인 종류는 주식회사, 유한회사, 합명회사, 합자회사, 유한책임회사, 사단법인, 재단법인, 의료법인, 협동조합(사회적협동조합 포함), 기타법인(특허법인 등)입니다. 한 건에 홈택스 서류 500포인트, 법인등기 열람용 1,000포인트, 제출용 1,500포인트를 차감합니다. [서류 발급 가이드](/docs/api-introduction/document-issuance) - name: 발급자 description: > 세금계산서 발행 주체인 발급자를 등록하고 관리합니다. 발행 방식에 따라 공동인증서 필요 여부가 다릅니다. [용어 정리](/docs/api-introduction/glossary) | [대리 정발행](/docs/api-introduction/usecase-delegated) | [위수탁 발행](/docs/api-introduction/usecase-brokered) - name: 인증서 description: > 발급자 공동인증서 등록 및 관리. [인증서 등록](/docs/api-introduction/certificate-registration) paths: /v1/businessProfiles/{businessRegistrationNumber}: get: tags: - 사업자 프로필 조회 summary: 사업자 프로필 상세 조회 description: > 사업자등록번호 한 건의 상세 프로필을 조회합니다. 발급자 등록과 공동인증서가 필요 없고, 요청자 관리번호도 쓰지 않습니다. 조회에 성공하면 90포인트를 차감하고, 프로필이 없는 번호(`404`)는 차감하지 않습니다. `registration`과 `taxation`은 볼타가 마지막으로 확인해 저장한 값입니다. 호출 시점의 상태가 필요하면 사업자등록 상태 조회 API를 쓰세요. 테스트 키는 가이드에 안내한 테스트 번호만 모의 조회합니다. [사업자 프로필 조회 가이드](/docs/api-introduction/business-profile) parameters: - name: businessRegistrationNumber in: path description: 조회할 사업자등록번호 10자리. 하이픈(-)을 포함해도 됩니다. required: true schema: type: string responses: '200': description: 조회 성공 content: application/json: schema: $ref: '#/components/schemas/BusinessProfileResponse' examples: 법인사업자: x-parity-id: corporate summary: 테스트 키로 1000000014를 조회한 결과. 모든 필드가 채워진 예시 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 개인사업자: x-parity-id: individual summary: 테스트 키로 1000000028을 조회한 결과. 법인 전용 값과 연락처가 없는 예시 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 상태를 확인한 적 없는 사업자: x-parity-id: never-checked summary: 테스트 키로 1000000111을 조회한 결과. 주소, 등록 상태, 과세 정보가 null인 예시 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: > 사업자등록번호가 10자리가 아닙니다. 테스트 키로 가이드에 없는 번호를 조회해도 같은 응답입니다. 이때 응답의 `code`는 `INVALID_REQUEST`입니다. 체크섬이 맞지 않으면 `code`가 `INVALID_BUSINESS_REGISTRATION_NUMBER`입니다. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: API 키 인증 실패. 응답 본문이 없습니다. '402': description: 포인트 잔액이 부족합니다. 응답의 `code`는 `PAYMENT_REQUIRED`입니다. 개발자센터에서 충전하세요. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: 볼타에 프로필이 없는 번호입니다. 응답의 `code`는 `NOT_FOUND`입니다. 포인트를 차감하지 않습니다. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: >- 진행 중인 다른 요청 때문에 지금 쓸 수 있는 포인트가 모자랍니다. 응답의 `code`는 `AVAILABLE_POINTS_INSUFFICIENT`입니다. 충전하거나 그 요청이 끝난 뒤 다시 요청하세요. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: >- 호출 한도인 1분에 300회를 넘었습니다. 응답의 `code`는 `RATE_LIMITED`입니다. `Retry-After` 이후에 다시 시도하세요. headers: Retry-After: description: 재시도까지 남은 시간(초) schema: type: integer content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: 서버 내부 오류. 응답의 `code`는 `INTERNAL_SERVER_ERROR`입니다. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '503': description: > 지금은 조회할 수 없습니다. 응답의 `code`는 `LOOKUP_UNAVAILABLE`입니다. 잠시 후 다시 시도하세요. 일시적인 내부 API 통신 오류일 때는 `SERVICE_UNAVAILABLE`입니다. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' deprecated: false components: schemas: BusinessProfileResponse: type: object description: 사업자 프로필 한 건. 모든 필드를 항상 담고, 값이 없으면 `null`, 목록은 빈 배열입니다. properties: businessRegistrationNumber: type: string description: 하이픈 없는 10자리 사업자등록번호 corporateRegistrationNumber: type: - string - 'null' description: 하이픈 없는 13자리 법인등록번호 businessKind: type: - string - 'null' enum: - INDIVIDUAL - CORPORATE - null description: 사업자 구분. `INDIVIDUAL` 개인사업자, `CORPORATE` 법인사업자입니다. commercialSalesNumber: type: - string - 'null' description: 통신판매업 신고번호 organizationName: type: - string - 'null' description: 상호 organizationNameEnglish: type: - string - 'null' description: 영문 상호 formerOrganizationNames: type: array description: 이전 상호. 최근에 바뀐 것부터 담습니다. items: $ref: '#/components/schemas/BusinessProfileFormerOrganizationName' representativeName: type: - string - 'null' description: 대표자명. 원천 자료가 가려서 준 값은 가린 그대로 담습니다. address: description: 주소. 원천 자료에 주소가 없으면 `null`입니다. oneOf: - $ref: '#/components/schemas/BusinessProfileAddress' - type: 'null' contact: $ref: '#/components/schemas/BusinessProfileContact' industry: $ref: '#/components/schemas/BusinessProfileIndustry' openedOn: type: - string - 'null' format: date description: 개업일 businessRegisteredOn: type: - string - 'null' format: date description: 사업자등록일 corporationEstablishedOn: type: - string - 'null' format: date description: 법인설립일 registration: description: 볼타가 마지막으로 확인한 사업자 등록 상태. 확인한 적이 없으면 `null`입니다. oneOf: - $ref: '#/components/schemas/BusinessProfileRegistration' - type: 'null' taxation: description: 볼타가 마지막으로 확인한 과세 정보. 모르면 `null`입니다. 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: API 요청 실패 시 반환되는 에러 응답 properties: code: type: string description: 에러 타입 식별자 message: type: string description: 에러 설명 traceId: type: string description: 요청 추적 식별자 required: - code - message - traceId BusinessProfileFormerOrganizationName: type: object description: 이전 상호 한 건 properties: name: type: string description: 이전 상호 changedOn: type: - string - 'null' format: date description: 새 상호가 공시 자료에 처음 나타난 날. 변경 등기일과 다를 수 있습니다. required: - name - changedOn BusinessProfileAddress: type: object description: 주소 properties: roadAddress: type: - string - 'null' description: 도로명주소 postalCode: type: - string - 'null' description: 우편번호 5자리 sidoCode: type: - string - 'null' description: 법정동 시도 코드 2자리 sigunguCode: type: - string - 'null' description: 법정동 시군구 코드 5자리 required: - roadAddress - postalCode - sidoCode - sigunguCode BusinessProfileContact: type: object description: 연락처. 연락처가 하나도 없어도 객체로 담습니다. properties: phone: type: - string - 'null' description: 대표 전화번호. 하이픈을 넣은 형식입니다. email: type: - string - 'null' description: 대표 이메일 websites: type: array description: 홈페이지 주소 items: type: string required: - phone - email - websites BusinessProfileIndustry: type: object description: 업종. 업종을 몰라도 객체로 담습니다. properties: businessType: type: - string - 'null' description: 업태. 국세청 등록 기준입니다. businessItem: type: - string - 'null' description: 종목. 국세청 등록 기준입니다. standardIndustry: description: 한국표준산업분류(11차) 세세분류. 코드는 5자리입니다. oneOf: - $ref: '#/components/schemas/BusinessProfileIndustryClassification' - type: 'null' category: description: 한국표준산업분류 대분류. 코드는 `A`부터 `U`까지입니다. oneOf: - $ref: '#/components/schemas/BusinessProfileIndustryClassification' - type: 'null' required: - businessType - businessItem - standardIndustry - category BusinessProfileRegistration: type: object description: 사업자 등록 상태 properties: status: $ref: '#/components/schemas/BusinessRegistrationStatusRegistrationState' closedOn: type: - string - 'null' format: date description: 폐업일. 폐업자가 아니면 `null`입니다. checkedAt: type: string format: date-time description: 국세청에 확인한 시각(UTC) required: - status - closedOn - checkedAt BusinessProfileTaxation: type: object description: 과세 정보 properties: type: $ref: '#/components/schemas/BusinessRegistrationStatusTaxationType' required: - type BusinessProfileIndustryClassification: type: object description: 한국표준산업분류 코드와 이름 properties: code: type: string description: 분류 코드 name: type: string description: 분류 이름 required: - code - name BusinessRegistrationStatusRegistrationState: type: string title: 사업자 등록 상태 description: >- `ACTIVE` 계속사업자, `SUSPENDED` 휴업자, `CLOSED` 폐업자, `NOT_REGISTERED` 미등록 번호, `UNKNOWN` 기타 등록 상태입니다. 통신 실패는 `UNKNOWN`이 아니라 `503`입니다. enum: - ACTIVE - SUSPENDED - CLOSED - NOT_REGISTERED - UNKNOWN BusinessRegistrationStatusTaxationType: type: string title: 과세유형 description: >- 국세청 과세유형. `GENERAL` 일반과세자, `SIMPLIFIED_RECEIPT_ISSUER` 세금계산서 발행이 불가능한 간이과세자, `SIMPLIFIED_TAX_INVOICE_ISSUER` 세금계산서 발행이 가능한 간이과세자, `SPECIAL_TAXPAYER` 과세특례자, `TAX_FREE` 면세사업자, `NONPROFIT` 수익사업을 영위하지 않는 비영리법인이거나 고유번호가 부여된 단체, `UNIQUE_NUMBER_ORGANIZATION` 고유번호가 부여된 단체입니다. 처음 보는 값은 기타로 처리하세요. enum: - GENERAL - SIMPLIFIED_RECEIPT_ISSUER - SIMPLIFIED_TAX_INVOICE_ISSUER - SPECIAL_TAXPAYER - TAX_FREE - NONPROFIT - UNIQUE_NUMBER_ORGANIZATION securitySchemes: basicAuth: type: http scheme: basic description: >- API 키 뒤에 콜론을 붙여 Base64로 인코딩해 헤더에 넣으세요. Username에 API 키를 입력하고 Password는 비워두세요. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.