사업자 전체정보

POST 
/bizno/v1/biz/info/all

사업자등록정보를 조회합니다 (전체정보 반환)

Request

application/json

Body

required

bizNoList string[]required

Possible values: >= 10 characters and <= 12 characters

조회요청할 사업자등록번호 목록 (최소 1건, 최대 10건)

Responses

200

application/json

Schema

Schema

• Array [

reqBizNo string

조회 요청한 사업자등록번호 (요청 본문의 bizNoList 순서대로 출력)

info

object

nullable

bizNo string

사업자등록번호

bizName string

상호

ceoName string

대표자명

zipCode string

우편번호

address string

도로명 주소

bizType string

사업자유형

bizStatus string

사업자상태

taxType string

과세유형

simplifiedTaxTypeDate stringnullable

간이-일반전환 연월일

closingDate stringnullable

폐업연월일

openingDate string

개업연월일

bizSectorName string

업태명 (국세청 업태, 업태가 없는 국가기관 또는 과거폐업 사업자는 빈 문자열 반환)

bizCategoryName string

종목명 (국세청 종목, 종목이 없는 국가기관 또는 과거폐업 사업자는 빈 문자열 반환)

bizCategoryCode string

업종코드 (업종이 없는 국가기관 또는 과거폐업 사업자는 빈 문자열 반환)

corpRegNo stringnullable

법인등록번호

phoneNumber stringnullable

전화번호

taxOfficeCode stringnullable

관할세무서코드

taxOfficeName stringnullable

관할세무서명

error stringnullable

조회오류 발생했을 때 오류메시지

• ]

Example (from schema)

[
  {
    "reqBizNo": "string",
    "info": {
      "bizNo": "string",
      "bizName": "string",
      "ceoName": "string",
      "zipCode": "string",
      "address": "string",
      "bizType": "개인' | '법인",
      "bizStatus": "영업' | '휴업' | '폐업",
      "taxType": "부가가치세 일반과세자' | '부가가치세 간이과세자' | '부가가치세 과세특례자' | '부가가치세 면세사업자'| '비영리법인, 단체, 국가기관 등' | '고유번호가 부여된 단체' | '계산서발급 간이과세자",
      "simplifiedTaxTypeDate": "2023-07-01",
      "closingDate": "2022-10-10",
      "openingDate": "2020-05-10",
      "bizSectorName": "서비스' | '",
      "bizCategoryName": "소프트웨어개발 및 공급업' | '",
      "bizCategoryCode": "722000' | '",
      "corpRegNo": "string",
      "phoneNumber": "string",
      "taxOfficeCode": "string",
      "taxOfficeName": "string"
    },
    "error": "string"
  }
]

400

입력내용 검증오류

application/json

Schema

Schema

errorId string

오류 식별자

error string

오류 유형

message string

오류 메시지

Example (from schema)

{
  "errorId": "string",
  "error": "Internal Server Error",
  "message": "서버에서 오류가 발생했습니다"
}

401

유효하지 않은 토큰을 사용한 경우

application/json

Schema

Schema

errorId string

오류 식별자

error string

오류 유형

message string

오류 메시지

Example (from schema)

{
  "errorId": "string",
  "error": "Internal Server Error",
  "message": "서버에서 오류가 발생했습니다"
}

500

연계기관 오류, 내부서버 오류 발생시

application/json

Schema

Schema

errorId string

오류 식별자

error string

오류 유형

message string

오류 메시지

Example (from schema)

{
  "errorId": "string",
  "error": "Internal Server Error",
  "message": "서버에서 오류가 발생했습니다"
}

Loading...