사업자 검색

POST /bizno/v1/biz/search

요청한 조건에 해당하는 사업자를 찾습니다

Request

인증토큰을 Authorization: Bearer <token> 헤더에 전달합니다.

필수 여부는 해당 객체 안에서 필드의 존재 여부를 뜻합니다. null 허용 여부와는 다르며, 부모 객체가 null이면 하위 필드는 반환되지 않습니다.

필드	타입	필수 여부	null	설명
query	string	필수	불가	검색할 문자열
attributes	string[]	선택	불가	(Optional) 검색할 속성: "bizName" 상호, "ceoName" 대표자명 · 기본값: ["bizName","ceoName"]
limit	number	선택	불가	(Optional) 검색결과 출력크기 · 기본값: 10 · 최솟값: 1 · 최댓값: 1000
offset	number	선택	불가	(Optional) 검색결과 출력시작 위치, 출력크기(limit + offset)는 최대 1,000 입니다 · 기본값: 0 · 최솟값: 0 · 최댓값: 999

필드	타입	필수 여부	null	설명
totalCount	number	필수	불가	전체 검색 결과 수 (최대 1,000건 까지 출력)
nondisclosureCount	number	필수	불가	응답 내 정보공개거부(해당 사업자 요청) 등으로 제외된 결과 수
list	object[]	필수	불가	검색 결과
list[].bizNo	string	필수	불가	사업자등록번호
list[].bizName	string	필수	불가	상호
list[].ceoName	string	필수	불가	대표자명
list[].zipCode	string	필수	불가	우편번호
list[].shortAddress	string	필수	불가	주소 (부분출력)