사업자 전체정보
POST/bizno/v1/biz/info/all
사업자등록정보를 조회합니다 (전체정보 반환)
Request
Responses
- 200
- 400
- 401
- 500
입력내용 검증오류
유효하지 않은 토큰을 사용한 경우
연계기관 오류, 내부서버 오류 발생시
연동 안내
인증토큰을 Authorization: Bearer <token> 헤더에 전달합니다.
연동 안내 · 오류 처리 · 데이터 갱신·운영 정책
필수 여부는 해당 객체 안에서 필드의 존재 여부를 뜻합니다. null 허용 여부와는 다르며, 부모 객체가 null이면 하위 필드는 반환되지 않습니다.
요청 필드
| 필드 | 타입 | 필수 여부 | null | 설명 |
|---|---|---|---|---|
| bizNoList | string[] | 필수 | 불가 | 조회요청할 사업자등록번호 목록 (최소 1건, 최대 10건) · 최소 항목 수: 1 · 최대 항목 수: 10 |
성공 응답 필드
| 필드 | 타입 | 필수 여부 | null | 설명 |
|---|---|---|---|---|
| [].reqBizNo | string | 필수 | 불가 | 조회 요청한 사업자등록번호 (요청 본문의 bizNoList 순서대로 출력) |
| [].info | object | 필수 | 허용 | 사업자등록정보 (오류 발생한 경우 null) |
| [].info.bizNo | string | 필수 | 불가 | 사업자등록번호 |
| [].info.bizName | string | 필수 | 불가 | 상호 |
| [].info.ceoName | string | 필수 | 불가 | 대표자명 |
| [].info.zipCode | string | 필수 | 불가 | 우편번호 |
| [].info.address | string | 필수 | 불가 | 도로명 주소 |
| [].info.bizType | string | 필수 | 불가 | 사업자유형 |
| [].info.bizStatus | string | 필수 | 불가 | 사업자상태 |
| [].info.taxTypeCode | string | 필수 | 불가 | 과세유형코드 (과세유형 순서와 과세유형코드 순서 동일, 국세청 OpenAPI 코드에 따름) |
| [].info.taxType | string | 필수 | 불가 | 과세유형 |
| [].info.simplifiedTaxTypeDate | string | 필수 | 허용 | 간이-일반전환 연월일 |
| [].info.issuableSimplifiedTaxTypeDate | string | 필수 | 허용 | 세금계산서발행간이 전환 연월일 |
| [].info.closingDate | string | 필수 | 허용 | 폐업연월일 |
| [].info.openingDate | string | 필수 | 불가 | 개업연월일 |
| [].info.bizSectorName | string | 필수 | 불가 | 업태명 (국세청 업태, 업태가 없는 국가기관 또는 과거폐업 사업자는 빈 문자열 반환) |
| [].info.bizCategoryName | string | 필수 | 불가 | 종목명 (국세청 종목, 종목이 없는 국가기관 또는 과거폐업 사업자는 빈 문자열 반환) |
| [].info.bizCategoryCode | string | 필수 | 불가 | 업종코드 (업종이 없는 국가기관 또는 과거폐업 사업자는 빈 문자열 반환) |
| [].info.corpRegNo | string | 필수 | 허용 | 법인등록번호 |
| [].info.phoneNumber | string | 필수 | 허용 | 전화번호 |
| [].info.taxOfficeCode | string | 필수 | 허용 | 관할세무서코드 |
| [].info.taxOfficeName | string | 필수 | 허용 | 관할세무서명 |
| [].error | string | 필수 | 허용 | 조회오류 발생했을 때 오류메시지 |