> ## 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. # 사업자등록 상태 일괄 조회 > 사업자등록번호를 한 번에 최대 100개까지 조회합니다. 각 항목의 결과는 단건 조회 응답과 같은 구조입니다. 발급자 등록과 공동인증서가 필요 없고, 요청자 관리번호도 쓰지 않습니다. 중복 번호는 처음 나온 것만 남기고, 요청 순서대로 `results`에 담습니다. 이번 요청에서 확인하지 못한 번호는 `status`가 `null`이니 잠시 후 그 번호만 다시 조회하세요. 한 건도 확인하지 못하면 `503`을 반환합니다. 테스트 키는 가이드에 안내한 고정 번호만 모의 조회하며, 목록 밖 번호가 하나라도 섞이면 요청 전체를 거절합니다. [사업자등록 상태 조회 가이드](/docs/api-introduction/business-registration-status) ## OpenAPI ````yaml /openapi.yaml post /v1/businessRegistrationStatuses:checkBulk 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: 전자(세금)계산서의 발행 결과와 요청 처리 상태를 조회합니다. - name: 세금계산서 역발행 description: > 전자(세금)계산서 역발행 요청 및 관리. [이메일 승인 역발행](/docs/api-introduction/usecase-reverse-email) | [간편 승인 역발행](/docs/api-introduction/usecase-reverse-simple) - name: 현금영수증 description: > 현금영수증을 발행·취소하고 처리 상태를 조회합니다. 최종 결과는 웹훅이나 상태 조회 API로 확인하세요. LIVE 요청 중 처리 중이거나 발행 결과 확인이 필요한 건은 요청일 다음 날 17:00(KST) 이후에 확정될 수 있습니다. [현금영수증 발행 가이드](/docs/api-introduction/cash-receipt-guide) | [현금영수증 웹훅](/docs/api-introduction/webhook-cash-receipt) - name: 사업자등록 상태 조회 description: > 사업자등록번호의 등록 상태와 과세유형을 단건 또는 최대 100건 일괄로 조회합니다. 발급자 등록과 공동인증서가 필요 없습니다. [사업자등록 상태 조회 가이드](/docs/api-introduction/business-registration-status) - 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/businessRegistrationStatuses:checkBulk: post: tags: - 사업자등록 상태 조회 summary: 사업자등록 상태 일괄 조회 description: > 사업자등록번호를 한 번에 최대 100개까지 조회합니다. 각 항목의 결과는 단건 조회 응답과 같은 구조입니다. 발급자 등록과 공동인증서가 필요 없고, 요청자 관리번호도 쓰지 않습니다. 중복 번호는 처음 나온 것만 남기고, 요청 순서대로 `results`에 담습니다. 이번 요청에서 확인하지 못한 번호는 `status`가 `null`이니 잠시 후 그 번호만 다시 조회하세요. 한 건도 확인하지 못하면 `503`을 반환합니다. 테스트 키는 가이드에 안내한 고정 번호만 모의 조회하며, 목록 밖 번호가 하나라도 섞이면 요청 전체를 거절합니다. [사업자등록 상태 조회 가이드](/docs/api-introduction/business-registration-status) requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BusinessRegistrationStatusBulkCheckRequest' examples: 여러 번호 조회: x-parity-id: multiple summary: 하이픈 없는 번호와 하이픈 포함 번호 value: businessRegistrationNumbers: - '1000000014' - 100-00-00028 - '1000000066' responses: '200': description: 조회 성공. 한 건 이상 확인했습니다. content: application/json: schema: $ref: '#/components/schemas/BusinessRegistrationStatusBulkResponse' examples: 모두 확인: x-parity-id: all-resolved summary: 모든 번호를 확인한 경우 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 일부 미확인: x-parity-id: partially-resolved summary: 라이브 키에서 일부 번호를 확인하지 못한 경우. 번호는 형식 예시입니다 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: > 번호 목록이 없거나 비어 있거나 100개를 넘습니다. 항목 중 하나라도 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' '403': description: 요청한 리소스에 접근할 권한이 없습니다. 응답의 `code`는 `FORBIDDEN`입니다. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: >- 파트너 호출 한도가 부족하거나, 한 건도 확인하지 못한 상태에서 볼타 서비스 전체의 일일 조회 한도에 도달했습니다. 한도는 조회한 번호 수로 셉니다. 응답의 `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: BusinessRegistrationStatusBulkCheckRequest: type: object description: 사업자등록 상태 일괄 조회 요청 properties: businessRegistrationNumbers: type: array description: 조회할 사업자등록번호 목록. 1개 이상 100개 이하로 입력하세요. 중복은 처음 나온 것만 남깁니다. minItems: 1 maxItems: 100 items: $ref: '#/components/schemas/BusinessRegistrationStatusQueryNumber' required: - businessRegistrationNumbers BusinessRegistrationStatusBulkResponse: type: object description: 사업자등록 상태 일괄 조회 결과 properties: results: type: array description: 요청한 번호마다 항목 하나. 중복을 줄인 뒤 요청 순서를 따릅니다. items: $ref: '#/components/schemas/BusinessRegistrationStatusBulkItem' required: - results ErrorResponse: type: object description: API 요청 실패 시 반환되는 에러 응답 properties: code: type: string description: 에러 타입 식별자 message: type: string description: 에러 설명 traceId: type: string description: 요청 추적 식별자 required: - code - message - traceId BusinessRegistrationStatusQueryNumber: type: string title: 조회할 사업자등록번호 description: >- 조회할 사업자등록번호 10자리. 하이픈(-)을 포함해도 됩니다. 응답은 하이픈을 제거한 10자리로 돌려줍니다. 예시는 테스트 키 전용 고정 번호입니다. pattern: ^\d{3}-?\d{2}-?\d{5}$ examples: - '1000000014' - 100-00-00014 BusinessRegistrationStatusBulkItem: type: object description: 일괄 조회의 번호별 결과 properties: businessRegistrationNumber: type: string description: 하이픈을 제거한 10자리 사업자등록번호 pattern: ^\d{10}$ status: description: 단건 조회 응답과 같은 구조. 이번 요청에서 확인하지 못했으면 `null`입니다. oneOf: - $ref: '#/components/schemas/BusinessRegistrationStatusResponse' - type: 'null' required: - businessRegistrationNumber - status BusinessRegistrationStatusResponse: type: object description: 사업자등록 상태 조회 결과. 세 필드를 항상 포함하고, 값이 없으면 `null`입니다. properties: businessRegistrationNumber: type: string description: 하이픈을 제거한 10자리 사업자등록번호 pattern: ^\d{10}$ registration: $ref: '#/components/schemas/BusinessRegistrationStatusRegistration' taxType: $ref: '#/components/schemas/BusinessRegistrationStatusTaxType' required: - businessRegistrationNumber - registration - taxType BusinessRegistrationStatusRegistration: type: object description: 사업자 등록 상태 properties: status: $ref: '#/components/schemas/BusinessRegistrationStatusRegistrationState' closedOn: type: - string - 'null' format: date description: 폐업일. 폐업자가 아니면 `null`입니다. required: - status - closedOn BusinessRegistrationStatusTaxType: type: - string - 'null' title: 과세유형 description: >- `GENERAL` 일반과세자, `SIMPLIFIED` 간이과세자, `TAX_FREE` 면세사업자, `NONPROFIT` 비영리, `OTHER_CORPORATION` 기타 법인입니다. 계속사업자 결과에서만 값이 있고 나머지는 `null`입니다. enum: - GENERAL - SIMPLIFIED - TAX_FREE - NONPROFIT - OTHER_CORPORATION - null BusinessRegistrationStatusRegistrationState: type: string title: 사업자 등록 상태 description: >- `ACTIVE` 계속사업자, `SUSPENDED` 휴업자, `CLOSED` 폐업자, `NOT_REGISTERED` 미등록 번호, `UNKNOWN` 기타 등록 상태입니다. 통신 실패는 `UNKNOWN`이 아니라 `503`입니다. enum: - ACTIVE - SUSPENDED - CLOSED - NOT_REGISTERED - UNKNOWN securitySchemes: basicAuth: type: http scheme: basic description: API 키를 Base64 인코딩하여 전달합니다. Username에 API 키를 입력하고 Password는 비워두세요. ````