사업자 기본정보

POST 
/bizno/v1/biz/info/base

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

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

폐업연월일

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"
    },
    "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...