{"openapi":"3.0.3","info":{"title":"APICK 차량 통합이력 조회","version":"1.0.0","description":"본인 간편인증 후 한국교통안전공단의 차량 통합이력 조회 자료를 확인합니다. 차량번호: 조회한 자동차등록번호 기본정보: 자동차 등록 원부 기본정보. 상류 코드값은 코드 그대로 온다. 검사이력: 정기검사 이력. 없으면 빈 배열이다. 정비이력: 정비 이력. 없으면 빈 배열이다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/req_vehicle_history":{"post":{"summary":"차량 통합이력 조회","description":"본인 간편인증 후 한국교통안전공단의 차량 통합이력 조회 자료를 확인합니다. 차량번호: 조회한 자동차등록번호 기본정보: 자동차 등록 원부 기본정보. 상류 코드값은 코드 그대로 온다. 검사이력: 정기검사 이력. 없으면 빈 배열이다. 정비이력: 정비 이력. 없으면 빈 배열이다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"schemaVersion":{"type":"string","description":"결과 스키마 버전 (고정값: \"1.0\")"},"transactionId":{"type":"string","description":"결과 조회에 사용하는 트랜잭션 ID"},"product":{"type":"string","description":"조회 항목 코드. 결과조회에도 같은 값이 오므로 어느 항목의 결과인지 대조할 수 있습니다."},"status":{"type":"string","description":"처리 상태 (AUTH_REQUESTED: 인증 요청 완료)"},"resultAvailable":{"type":"boolean","description":"결과 데이터 포함 여부. 인증 요청 응답은 항상 false 입니다."},"charged":{"type":"boolean","description":"이번 호출의 과금 발생 여부. 실제 발송에 성공하면 true 입니다."},"sources":{"type":"array","items":{},"description":"항상 포함됩니다. 값이 없으면 빈 배열 [] 입니다. 항목이 여러 개인 상품에서 어느 것이 성공·실패했는지 알려줍니다. 각 항목은 source(제공 기관명), type(데이터 종류), status(SUCCESS/FAILED). 수집이 끝나기 전에는 아직 확정되지 않은 기관이 FAILED 로 보일 수 있습니다."},"message":{"type":"string","description":"상태 메시지 (고정값: \"인증 대기중입니다.\")"},"expiresAt":{"type":"string","description":"인증 유효 기한(ISO 8601). 이 시각까지 승인하지 못하면 인증 실패 처리됩니다."},"success":{"type":"integer","description":"과금 여부0: 실패 또는 재사용(무과금)1: 발송 성공(과금)"}},"description":"인증 요청 결과"},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"API 서버 정상 응답 여부"},"cost":{"type":"integer","description":"API 호출 요금"},"ms":{"type":"integer","description":"API 응답 시간"},"pl_id":{"type":"integer","description":"API 결제 로그 ID"}},"description":"API 호출 공통 데이터"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"이름 (string)"},"birthDate":{"type":"string","description":"생년월일 8자리(YYYYMMDD) (string)"},"phone":{"type":"string","description":"휴대전화 번호 (본인 명의, 숫자만) (string)"},"authProvider":{"type":"string","description":"간편인증 방식 (아래 지원 목록 참고) (string)"},"carNumber":{"type":"string","description":"자동차등록번호 (string)"},"rrn":{"type":"string","description":"주민등록번호 13자리 또는 뒤 7자리 (string)"}},"required":["name","birthDate","phone","authProvider","carNumber","rrn"]}}}}}},"/rest/get_vehicle_history":{"post":{"summary":"차량 통합이력 조회","description":"본인 간편인증 후 한국교통안전공단의 차량 통합이력 조회 자료를 확인합니다. 차량번호: 조회한 자동차등록번호 기본정보: 자동차 등록 원부 기본정보. 상류 코드값은 코드 그대로 온다. 검사이력: 정기검사 이력. 없으면 빈 배열이다. 정비이력: 정비 이력. 없으면 빈 배열이다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"schemaVersion":{"type":"string","description":"결과 스키마 버전 (고정값: \"1.0\")"},"transactionId":{"type":"string","description":"결과 조회에 사용하는 트랜잭션 ID"},"product":{"type":"string","description":"조회 항목 코드. 결과조회에도 같은 값이 오므로 어느 항목의 결과인지 대조할 수 있습니다."},"status":{"type":"string","description":"처리 상태 (AUTH_REQUESTED: 인증 요청 완료)"},"resultAvailable":{"type":"boolean","description":"결과 데이터 포함 여부. 인증 요청 응답은 항상 false 입니다."},"charged":{"type":"boolean","description":"이번 호출의 과금 발생 여부. 실제 발송에 성공하면 true 입니다."},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"type":{"type":"string"},"status":{"type":"string"}}},"description":"항상 포함됩니다. 값이 없으면 빈 배열 [] 입니다. 항목이 여러 개인 상품에서 어느 것이 성공·실패했는지 알려줍니다. 각 항목은 source(제공 기관명), type(데이터 종류), status(SUCCESS/FAILED). 수집이 끝나기 전에는 아직 확정되지 않은 기관이 FAILED 로 보일 수 있습니다."},"message":{"type":"string","description":"상태 메시지 (고정값: \"인증 대기중입니다.\")"},"expiresAt":{"type":"string","description":"인증 유효 기한(ISO 8601). 이 시각까지 승인하지 못하면 인증 실패 처리됩니다."},"success":{"type":"integer","description":"과금 여부0: 실패 또는 재사용(무과금)1: 발송 성공(과금)"},"progress":{"type":"object","properties":{"total":{"type":"integer"},"completed":{"type":"integer"}},"description":"진행률(COLLECTING 일 때). total(전체 항목), completed(완료 항목)"},"checkedAt":{"type":"string","description":"실제 정보를 확인한 시각. 한국시간(UTC+09:00) ISO 8601 이며 재조회 유효기간의 기준입니다."},"resultExpiresAt":{"type":"string","description":"결과 재조회 만료 시각. 한국시간(UTC+09:00) ISO 8601 입니다."},"result":{"type":"object","properties":{"vehicleHistory":{"type":"object","additionalProperties":true,"properties":{"차량번호":{"type":"string","description":"조회한 자동차등록번호"},"기본정보":{"type":"object","description":"자동차 등록 원부 기본정보. 상류 코드값은 코드 그대로 온다.","properties":{"자동차등록번호":{"type":"string","description":"등록번호"},"차대번호":{"type":"string","description":"차대번호(VIN)"},"용도":{"type":"string","description":"용도 코드"},"차명":{"type":"string","description":"차명"},"차종":{"type":"string","description":"차종 코드"},"양도연월일":{"type":"string","description":"양도 연월일"},"최초 등록일":{"type":"string","description":"최초 등록일"},"연식":{"type":"string","description":"연식"},"색상":{"type":"string","description":"색상 코드"},"검사유효기간":{"type":"string","description":"검사 유효기간"},"이전등록횟수":{"type":"string","description":"이전 등록 횟수"},"영업등록횟수":{"type":"string","description":"영업 등록 횟수"},"운행정지명령일자":{"type":"string","description":"운행정지 명령일. 없으면 \"-\""}}},"검사이력":{"type":"array","description":"정기검사 이력. 없으면 빈 배열이다.","items":{"type":"object","properties":{"번호":{"type":"string","description":"순번"},"검사구분":{"type":"string","description":"검사 구분"},"검사일":{"type":"string","description":"검사일"},"검사소":{"type":"string","description":"검사소명"},"검사유효기간":{"type":"string","description":"검사 유효기간"}}}},"정비이력":{"type":"array","description":"정비 이력. 없으면 빈 배열이다.","items":{"type":"object","properties":{"번호":{"type":"string","description":"순번"},"정비업체명":{"type":"string","description":"정비업체명"},"출고일자":{"type":"string","description":"출고일자"},"주행거리(㎞)":{"type":"string","description":"출고 시 주행거리(㎞)"},"작업내역":{"type":"string","description":"작업내역"}}}},"중고차성능점검이력":{"type":"array","description":"중고차 성능·상태 점검이력. 없으면 빈 배열이다.","items":{"type":"object","properties":{"번호":{"type":"string","description":"순번"},"접수번호":{"type":"string","description":"점검 접수번호"},"매매업체명":{"type":"string","description":"점검을 의뢰한 매매업체명"},"검정일자":{"type":"string","description":"검정일자"},"주행거리(㎞)":{"type":"string","description":"검정 시 주행거리(㎞)"},"등록상태":{"type":"string","description":"등록상태"}}}},"의무보험가입정보":{"type":"array","description":"의무보험 가입 이력. 없으면 빈 배열이다.","items":{"type":"object","properties":{"가입회사":{"type":"string","description":"보험사명"},"보험종목":{"type":"string","description":"보험 종목"},"가입상태":{"type":"string","description":"가입 상태"},"가입기간시작일":{"type":"string","description":"가입 시작일"},"가입기간종료일":{"type":"string","description":"가입 종료일"}}}},"자동차세체납이력":{"type":"array","description":"자동차세 체납 이력. 없으면 빈 배열이다.","items":{"type":"object","properties":{"과세년월":{"type":"string","description":"과세 연월"},"체납금액":{"type":"string","description":"체납금액(원)"},"체납세목":{"type":"string","description":"체납 세목"}}}},"압류등록이력":{"type":"array","description":"압류 등록 이력. 없으면 빈 배열이다.","items":{"type":"object","properties":{"압류등록일자":{"type":"string","description":"압류 등록일자"},"촉탁기관":{"type":"string","description":"촉탁 기관명"},"압류번호":{"type":"string","description":"압류번호"},"압류내역":{"type":"string","description":"압류 내역"}}}},"저당권등록이력":{"type":"array","description":"저당권 등록 이력. 없으면 빈 배열이다.","items":{"type":"object","properties":{"저당권등록일자":{"type":"string","description":"저당권 등록일자"},"채권자":{"type":"string","description":"채권자"},"저당가액":{"type":"string","description":"저당가액(원)"}}}},"폐차정보":{"type":"object","description":"폐차 정보. 자료가 없으면 null이다.","nullable":true,"properties":{"폐차장소명":{"type":"string","description":"폐차 장소명"},"소유자말소등록여부":{"type":"string","description":"소유자 말소등록 여부"},"번호판반납수":{"type":"string","description":"번호판 반납 수"},"자동차등록증인수폐기여부":{"type":"string","description":"자동차등록증 인수·폐기 여부"},"폐차인수일":{"type":"string","description":"폐차 인수일"}}},"주행거리이력":{"type":"array","description":"주행거리 등록 이력. 없으면 빈 배열이다.","items":{"type":"object","properties":{"번호":{"type":"string","description":"순번"},"주행거리(㎞)":{"type":"string","description":"등록된 주행거리(㎞)"},"등록구분":{"type":"string","description":"등록 구분"},"등록업체":{"type":"string","description":"등록 업체명"},"등록일":{"type":"string","description":"등록일"}}}},"튜닝이력":{"type":"array","description":"튜닝 이력. 없으면 빈 배열이다.","items":{"type":"object","properties":{"튜닝일자":{"type":"string","description":"튜닝일자"},"튜닝명세":{"type":"string","description":"튜닝 명세"}}}},"전손처리정보":{"type":"object","description":"전손 처리 구분과 수리검사 횟수. 자료가 없으면 null이다.","nullable":true,"properties":{"전손처리구분":{"type":"string","description":"전손 처리 구분. 없으면 \"-\""},"수리검사횟수":{"type":"string","description":"수리검사 횟수"}}},"제3자조회요약":{"type":"object","description":"타인차량(미동의) 경로가 주는 건수·여부 요약. 화면이 주는 제목을 그대로 키로 쓴다. 자료가 없는 항목은 키가 빠진다.","properties":{"검사이력":{"type":"array","description":"타인차량 경로의 검사 이력. 없으면 키가 빠진다.","items":{"type":"object"}},"정비이력횟수":{"type":"object","description":"정비 이력 건수","properties":{}},"중고차성능점검횟수":{"type":"object","description":"중고차 성능점검 건수","properties":{}},"의무보험가입여부":{"type":"object","description":"의무보험 가입 여부","properties":{}},"자동차세체납횟수":{"type":"object","description":"자동차세 체납 이력. 없으면 키가 빠진다.","properties":{}},"압류건수":{"type":"object","description":"압류 건수","properties":{}},"저당건수":{"type":"object","description":"저당 건수","properties":{}},"폐차인수증명서발급여부":{"type":"object","description":"폐차 인수증명서 발급 여부","properties":{}},"국토부인정정보":{"type":"object","description":"국토부 인정 정보(튜닝 횟수·전손 처리 구분)","properties":{}}}},"평균매매가":{"type":"object","description":"연식·형식 기준 평균 매매가. 대상 건이 없으면 null이다.","nullable":true,"properties":{"차명":{"type":"string","description":"차명"},"형식":{"type":"string","description":"형식"},"연식":{"type":"string","description":"연식"},"팔 때 대상건수(건)":{"type":"string","description":"개인이 업자에게 판 거래 건수"},"팔 때 평균매매금액(원)":{"type":"string","description":"개인이 업자에게 판 평균 금액(원)"},"살 때 대상건수(건)":{"type":"string","description":"업자가 개인에게 판 거래 건수. 없으면 \"-\""},"살 때 평균매매금액(원)":{"type":"string","description":"업자가 개인에게 판 평균 금액(원). 없으면 \"-\""}}}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."}},"description":"조회된 결과 묶음. 실제 데이터가 있을 때만 포함됩니다."}},"description":"인증 요청 결과"},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"API 서버 정상 응답 여부"},"cost":{"type":"integer","description":"API 호출 요금"},"ms":{"type":"integer","description":"API 응답 시간"},"pl_id":{"type":"integer","description":"API 결제 로그 ID"}},"description":"API 호출 공통 데이터"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"transactionId":{"type":"string","description":"/rest/req_vehicle_history 가 반환한 트랜잭션 ID (string)"}},"required":["transactionId"]}}}}}}},"x-code-tables":[],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}