{"openapi":"3.0.3","info":{"title":"APICK 통신판매업 신고 조회","version":"1.0.0","description":"사업자등록번호로 통신판매업 신고 이력 전부(신고번호·상호·대표자·운영상태·신고일자·신고기관·소재지)를 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/ecommerce_registration":{"post":{"summary":"통신판매업 신고 조회","description":"사업자등록번호로 통신판매업 신고 이력 전부(신고번호·상호·대표자·운영상태·신고일자·신고기관·소재지)를 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"biz_no":{"type":"string","description":"조회한 사업자등록번호(숫자 10자리)입니다."},"count":{"type":"integer","description":"신고 이력 수입니다. 0이면 신고 이력이 없는 것이며 요금은 차감됩니다."},"active":{"type":"boolean","description":"운영상태가 정상영업인 신고가 한 건이라도 있으면 true입니다."},"active_count":{"type":"integer","description":"정상영업 중인 신고 수입니다."},"representative":{"type":"object","properties":{"신고번호":{"type":"string"},"상호":{"type":"string"},"대표자명":{"type":"string"},"운영상태":{"type":"string"},"신고일자":{"type":"string"},"신고기관":{"type":"string"},"시도":{"type":"string"},"소재지주소":{"type":"string"},"도로명주소":{"type":"string"},"법인등록번호":{"type":"string"},"대표자이메일":{"type":"string"},"담당부서":{"type":"string"},"담당부서전화":{"type":"string"}},"description":"대표 신고입니다. items의 첫 항목과 같고, 이력이 없으면 null입니다.","nullable":true},"items":{"type":"array","items":{"type":"object","properties":{"신고번호":{"type":"string","description":"통신판매업 신고번호입니다. 예: 2024-서울강남-01234."},"상호":{"type":"string","description":"신고한 상호(법인명)입니다."},"운영상태":{"type":"string","description":"정상영업·휴업·폐업 등 신고의 현재 상태입니다."},"신고일자":{"type":"string","description":"신고한 날짜 YYYY-MM-DD입니다."},"…":{"type":"string"},"대표자명":{"type":"string","description":"대표자 이름입니다. 공동대표는 쉼표로 이어져 옵니다."},"신고기관":{"type":"string","description":"신고를 받은 시·군·구입니다. 예: 서울특별시 강남구."},"시도":{"type":"string","description":"사업장이 있는 시·도입니다."},"소재지주소":{"type":"string","description":"사업장 지번 주소입니다."},"도로명주소":{"type":"string","description":"사업장 도로명 주소입니다. 건물 번호 없이 도로명까지만 올 수 있습니다."},"법인등록번호":{"type":"string","description":"법인이면 000000-0000000 형식의 법인등록번호이고, 개인사업자는 빈 문자열입니다."},"대표자이메일":{"type":"string","description":"신고서에 적힌 대표 연락 이메일입니다. 없으면 빈 문자열입니다."},"담당부서":{"type":"string","description":"신고를 관리하는 시·군·구 담당 부서입니다."},"담당부서전화":{"type":"string","description":"담당 부서 전화번호입니다."}}},"description":"신고 이력 목록입니다. 정상영업 신고가 앞에 오고, 같은 상태 안에서는 신고일자 최신순입니다."},"success":{"type":"integer","description":"1이면 정상 조회입니다."}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"차감된 포인트입니다. 이력이 없거나 실패하면 0 입니다."},"ms":{"type":"integer"},"pl_id":{"type":"integer"}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"biz_no":{"type":"string","description":"사업자등록번호 10자리입니다. 하이픈 없이 숫자만 입력하며, 검증 숫자(체크섬)가 맞지 않으면 조회 전에 거부됩니다. (string)","example":"9999999906"}},"required":["biz_no"]}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["data.error","의미","대처"],"rows":[["사업자등록번호(biz_no)는 숫자 10자리로 보내 주세요. 예: 1234567890","biz_no가 없거나 숫자 10자리가 아닙니다.","번호를 고쳐 다시 요청합니다."],["사업자등록번호(biz_no)가 올바르지 않습니다. 검증 숫자가 맞지 않습니다.","10자리이지만 있을 수 없는 번호입니다.","번호를 다시 확인합니다. 과금되지 않습니다."],["통신판매업 신고 정보를 가져오지 못했습니다. 잠시 후 다시 시도해 주세요.","일시적으로 조회하지 못했습니다.","잠시 후 다시 요청합니다. 과금되지 않습니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}