Scraping API Guide

정부24_여권정보조회(간편인증)

정부24 여권정보조회(간편인증) API는 정부24에서 제공하는 여권정보증명서(국문/영문) 발급 업무를 간편인증(민간인증서) 방식으로 연동하여,
본인 인증이 완료된 사용자가 자신이 발급받은 여권 정보를 조회·확인할 수 있도록 제공하는 서비스입니다.

해당 API는 본인정보(성명, 생년월일 등)를 입력하고 간편인증을 완료한 사용자를 대상으로,
본인이 발급받은 여권에 대한 모든 주요 정보(여권번호, 영문명, 발급일, 유효기간, 여권종류 등)를 조회할 수 있도록 지원합니다.

즉, 별도의 서류 제출 없이도 간편인증을 통해 본인 확인이 완료되면,
해당 사용자의 여권 발급 이력 및 현재 유효한 여권 정보가 정부24 기준으로 조회됩니다.

METHOD

POST

URI

/scrap/common/gov/v1/Passport_Simple

Content Type

application/json

Charset

UTF-8

Last Updated

2026-01-23

Request Fields

필드명(영문)	필드명(한글)	필수여부	암호화여부	타입	양식	설명
LOGINOPTION	간편인증로그인방법	true		STRING	0: 카카오톡 1: 삼성패스 3: 통신사 4: KB모바일인증서 5: 네이버인증서 6: 신한인증서 7: 토스 인증서 8: 뱅크샐러드 9: KEB하나은행 10: NH인증서 12: 우리은행 13: 카카오뱅크	간편인증 로그인시 필수필드
WAITOPTION	간편인증 대기 방법			STRING	0: 2path인증 1(기본): 1path인증	2path로 사용시, 하단 가이드 문서를 확인해주시기 바랍니다. https://spiced-anchovy-23e.notion.site/2pathguide
TELECOMGUBUN	통신사구분			STRING	1: SKT, 2: KT, 3: LGU+	간편인증이 3번(통신사PASS)일 경우 필수임. 알뜰폰일 경우 같은 통신사 망을 선택해주시기 바랍니다. ex) KT알뜰폰일 경우 KT로 선택해야 함.
REQNAME	요청자 이름	true		STRING		신청자명을 입력해주시기 바랍니다.
REQJUMIN	요청자 주민등록번호	true	true	NUMBER		주민등록번호 -없이 13자리 입력 바랍니다.
REQHPNO	휴대폰번호	true		STRING

필드명(영문)

필드명(한글)

필수여부

암호화여부

타입

양식

최대길이

샘플데이터

설명

LOGINOPTION

간편인증로그인방법

true

STRING

0: 카카오톡
1: 삼성패스
3: 통신사
4: KB모바일인증서
5: 네이버인증서
6: 신한인증서
7: 토스 인증서
8: 뱅크샐러드
9: KEB하나은행
10: NH인증서
12: 우리은행
13: 카카오뱅크

간편인증 로그인시 필수필드

WAITOPTION

간편인증 대기 방법

STRING

0: 2path인증
1(기본): 1path인증

2path로 사용시, 하단 가이드 문서를 확인해주시기 바랍니다.
https://spiced-anchovy-23e.notion.site/2pathguide

TELECOMGUBUN

통신사구분

STRING

1: SKT,
2: KT,
3: LGU+

간편인증이 3번(통신사PASS)일 경우 필수임.
알뜰폰일 경우 같은 통신사 망을 선택해주시기 바랍니다.
ex) KT알뜰폰일 경우 KT로 선택해야 함.

REQNAME

요청자 이름

true

STRING

신청자명을 입력해주시기 바랍니다.

REQJUMIN

요청자 주민등록번호

true

NUMBER

주민등록번호 -없이 13자리 입력 바랍니다.

REQHPNO

휴대폰번호

true

STRING

Response Fields

필드명(영문)

필드명(한글)

필수여부

암호화여부

타입

양식

최대길이

샘플데이터

설명

errCode

STRING

정상일 때는 '0000', 오류일 경우 오류코드 반환

errMsg

STRING

오류발생 시 오류메시지

result

STRING

SUCCESS/FAIL

data.RESULT

전체 성공/실패 여부

STRING

SUCCESS : 성공
FAIL :실패

data.ERRMSG

에러메세지

STRING

RESULT값이 FAIL일 경우 스크래핑 서비스 오류 메세지 출력

data.ECODE

에러코드

STRING

오류코드 리스트는 하단 내용을 참고해주시기 바랍니다.
https://spiced-anchovy-23e.notion.site/gov72simpleecode

data.ETRACK

에러추적번호

STRING

data.PASSPORTINFOLIST[]

여권정보 리스트

ARRAY

현재 유효한 여권정보 리스트만 추출

data.PASSPORTINFOLIST[].PASSPORTTYPE

여권 유형 구분(여권종류 / Type)

STRING

현재 유효한 여권 정보 리스트만 추출함

data.PASSPORTINFOLIST[].EXPIRATIONDATE

기간만료일

STRING

yyyyMMdd

현재 유효한 여권정보 리스트만 추출함

data.PASSPORTINFOLIST[].ISSUEDATE

발급일자

STRING

yyyyMMdd

data.PASSPORTINFOLIST[].PASSPORTNUM

여권정보

true

STRING

현재 유효한 여권정보 리스트만 추출함

data.PASSPORTINFOLIST[].ENGLISHNAME

영문성명

STRING

현재 유효한 여권정보 리스트만 추출함

HTTP Request

POST /scrap/common/gov/v1/Passport_Simple
Host: https://datahub-dev.scraping.co.kr
Authorization: Token ******************************
Content-Length: 159
Content-Type: application/json;charset=UTF-8

{
  "LOGINOPTION" : "0",
  "WAITOPTION" : "",
  "TELECOMGUBUN" : null,
  "REQNAME" : "홍길동",
  "REQJUMIN" : "8SxYL+DfTfMfIOWng==",
  "REQHPNO" : "01012345678"
}

HTTP Response

HTTP/1.1 200 OK
Date:Fri, 23 Jan 2026 09:25:50 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Content-Length: 401

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "ETRACK" : "",
    "PASSPORTINFOLIST" : [ {
      "ISSUEDATE" : "20240822",
      "ENGLISHNAME" : "YOUNGMI  CHOI",
      "EXPIRATIONDATE" : "20340822",
      "PASSPORTTYPE" : "일반복수(PM)",
      "PASSPORTNUM" : "u6AX4uYHxYA069gwOewgOA=="
    } ],
    "ERRMSG" : "",
    "ECODE" : "",
    "RESULT" : "SUCCESS"
  }
}

Curl Request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/common/gov/v1/Passport_Simple' -i -X POST \
     -H 'Authorization: Token ******************************' \
     -H 'Content-Type: application/json;charset=UTF-8' \
     -d '{
  "LOGINOPTION" : "0",
  "WAITOPTION" : "",
  "TELECOMGUBUN" : null,
  "REQNAME" : "홍길동",
  "REQJUMIN" : "8SxYL+DfTfMfIOWng==",
  "REQHPNO" : "01012345678"
}'

필드명(영문)	필드명(한글)	양식	설명
data.callbackId	콜백ID
data.callbackType	구분	'SMS', 'CAPTCHA', 'OTP', 'TWO', 'SINGLE', 'SIMPLE' , 'ANY'
data.callbackData	구분 값	Base64 Image.	data.callbackType 필드가 'CAPTCHA’일 경우 Image 응답.
data.timeout	타임아웃		해당시간까지 입력 가능

필드명(한글)

양식

설명

data.callbackId

콜백ID

data.callbackType

구분

'SMS', 'CAPTCHA', 'OTP', 'TWO', 'SINGLE', 'SIMPLE' , 'ANY'

data.callbackData

구분 값

Base64 Image.

data.callbackType 필드가 'CAPTCHA’일 경우 Image 응답.

data.timeout

타임아웃

해당시간까지 입력 가능

Request

다음의 API 로 요청

METHOD

POST

URI

/scrap/captcha

필드명(영문)	필드명(한글)	양식	설명
callbackId	콜백ID		data.callbackId 필드로 응답받은 콜백ID 입력
callbackType	구분	'SMS', 'CAPTCHA', 'OTP', 'TWO', 'SINGLE', 'SIMPLE' ,'ANY'	data.callbackType 필드로 응답 받은 구분 입력
callbackResponse	구분 값		callbackType(구분)이 'SMS', 'CAPTCHA', 'OTP', 'SINGLE’일 경우 인증문자 입력.
callbackResponse1	임시 비밀번호		callbackType(구분)이 'TWO’일 경우에만 해당. 요청 시 입력한 Email로 받은 임시 비밀번호.
callbackResponse2	변경할 비밀번호		callbackType(구분)이 'TWO’일 경우에만 해당.
retry	캡챠이미지 갱신여부	'Y':이미지 갱신	callbackType(구분)이 'CAPTCHA’일 경우에만 해당.

필드명(영문)

필드명(한글)

양식

설명

callbackId

콜백ID

data.callbackId 필드로 응답받은 콜백ID 입력

callbackType

구분

'SMS', 'CAPTCHA', 'OTP', 'TWO', 'SINGLE', 'SIMPLE' ,'ANY'

data.callbackType 필드로 응답 받은 구분 입력

callbackResponse

구분 값

callbackType(구분)이 'SMS', 'CAPTCHA', 'OTP', 'SINGLE’일 경우 인증문자 입력.

callbackResponse1

임시 비밀번호

callbackType(구분)이 'TWO’일 경우에만 해당. 요청 시 입력한 Email로 받은 임시 비밀번호.

callbackResponse2

변경할 비밀번호

callbackType(구분)이 'TWO’일 경우에만 해당.

retry

캡챠이미지 갱신여부

'Y':이미지 갱신

callbackType(구분)이 'CAPTCHA’일 경우에만 해당.

정부24_여권정보조회(간편인증)

Request Fields

Response Fields

HTTP Request

HTTP Response

Curl Request

참고자료

2 Path Fields

Response

Request