Korean business, bid and real-estate analytics, parcel, building register and simple-auth data
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer <APICK license key>. Get a free key with 1,000 free points at https://apick.app (tools/list works without a key).
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Get iOS app metadata and customer reviews by numeric app id. iOS 앱 정보(평점·가격·장르)와 고객 리뷰를 함께 돌려줍니다. country 기본 kr, page 로 리뷰 페이지를 넘깁니다(최대 10). [호출당 100포인트]
iOS 앱 ID (숫자)
리뷰 페이지 (기본 1, 최대 10)
국가 코드 (기본 kr)
Tool list last changed Oct 23, 2026.
Get iOS app metadata and customer reviews by numeric app id. iOS 앱 정보(평점·가격·장르)와 고객 리뷰를 함께 돌려줍니다. country 기본 kr, page 로 리뷰 페이지를 넘깁니다(최대 10). [호출당 100포인트]
| Argument | Type | Description |
|---|---|---|
| page | integer | 리뷰 페이지 (기본 1, 최대 10) |
| appId* | string | iOS 앱 ID (숫자) |
| country | string | 국가 코드 (기본 kr) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"appId"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "리뷰 페이지 (기본 1, 최대 10)"
},
"appId": {
"type": "string",
"pattern": "^[0-9]{1,12}$",
"description": "iOS 앱 ID (숫자)"
},
"country": {
"type": "string",
"pattern": "^[a-z]{2}$",
"description": "국가 코드 (기본 kr)"
}
}
}Analyze Korean public-sector award results: success-rate distribution and averages, winner concentration, low-rate notices. 공공기관 낙찰 결과를 모아 평균·중위 낙찰률, 낙찰률 분포, 업체별 낙찰 점유와 집중도(HHI), 저가 낙찰 공고를 분석합니다. 응답은 summary·distribution·competitors·low_rate·insights 이며 원문 목록은 제공하지 않습니다. [호출당 50포인트]
| Argument | Type | Description |
|---|---|---|
| pageNo | integer | 페이지 번호 (기본 1) |
| bizType | string | 업무구분 (물품·공사·용역·외자, 기본 용역) |
| endDate | string | 조회 종료일 (YYYYMMDD 또는 YYYYMMDDHHMM) |
| bidNtceNo | string | 입찰공고번호 (지정 시 공고번호로 조회) |
| numOfRows | integer | 페이지당 결과 수 (기본 10, 최대 999) |
| startDate | string | 조회 시작일 (YYYYMMDD 또는 YYYYMMDDHHMM) |
| indstrytyCd | string | 업종코드 (선택) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"pageNo": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "페이지 번호 (기본 1)"
},
"bizType": {
"enum": [
"물품",
"공사",
"용역",
"외자"
],
"type": "string",
"description": "업무구분 (물품·공사·용역·외자, 기본 용역)"
},
"endDate": {
"type": "string",
"description": "조회 종료일 (YYYYMMDD 또는 YYYYMMDDHHMM)"
},
"bidNtceNo": {
"type": "string",
"pattern": "^[A-Za-z0-9]*[0-9][A-Za-z0-9]*(?![\\s\\S])",
"maxLength": 20,
"minLength": 1,
"description": "입찰공고번호 (지정 시 공고번호로 조회)"
},
"numOfRows": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "페이지당 결과 수 (기본 10, 최대 999)"
},
"startDate": {
"type": "string",
"description": "조회 시작일 (YYYYMMDD 또는 YYYYMMDDHHMM)"
},
"indstrytyCd": {
"type": "string",
"description": "업종코드 (선택)"
}
}
}Analyze Korean public-sector bid notices: budget bands, agencies, industries, closing urgency and largest opportunities. 공공기관 입찰공고를 모아 예산구간·발주기관·업종 분포, 마감 임박 공고, 규모 상위 공고를 분석합니다. 응답은 summary·distribution·deadlines·largest·insights 이며 공고 원문 목록은 제공하지 않습니다. bizType 을 생략하면 용역 공고를 분석합니다. [호출당 50포인트]
| Argument | Type | Description |
|---|---|---|
| pageNo | integer | 페이지 번호 (기본 1) |
| bizType | string | 업무구분 (물품·공사·용역·외자, 기본 용역) |
| endDate | string | 조회 종료일 (YYYYMMDD 또는 YYYYMMDDHHMM) |
| bidNtceNo | string | 입찰공고번호 (지정 시 공고번호로 조회) |
| numOfRows | integer | 페이지당 결과 수 (기본 10, 최대 999) |
| startDate | string | 조회 시작일 (YYYYMMDD 또는 YYYYMMDDHHMM) |
| indstrytyCd | string | 업종코드 (선택) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"pageNo": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "페이지 번호 (기본 1)"
},
"bizType": {
"enum": [
"물품",
"공사",
"용역",
"외자"
],
"type": "string",
"description": "업무구분 (물품·공사·용역·외자, 기본 용역)"
},
"endDate": {
"type": "string",
"description": "조회 종료일 (YYYYMMDD 또는 YYYYMMDDHHMM)"
},
"bidNtceNo": {
"type": "string",
"pattern": "^[A-Za-z0-9]*[0-9][A-Za-z0-9]*(?![\\s\\S])",
"maxLength": 20,
"minLength": 1,
"description": "입찰공고번호 (지정 시 공고번호로 조회)"
},
"numOfRows": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "페이지당 결과 수 (기본 10, 최대 999)"
},
"startDate": {
"type": "string",
"description": "조회 시작일 (YYYYMMDD 또는 YYYYMMDDHHMM)"
},
"indstrytyCd": {
"type": "string",
"description": "업종코드 (선택)"
}
}
}Look up general status information of a Korean business by its 10-digit business registration number. 사업자등록번호로 해당 사업자의 일반 현황 정보(대표자, 주소, 직원수, 설립일, 업종, 업태, 종목, 연락처, 사업자상태, 과세유형 등)를 조회합니다. 법인은 financial_info=Y 로 기업재무정보(요약재무제표·재무상태표·손익계산서)를 추가 요금 없이 함께 받을 수 있습니다. [호출당 50포인트]
| Argument | Type | Description |
|---|---|---|
| biz_no* | string | 사업자등록번호 (숫자 10자리, 하이픈 제외, 예: 1234567890) |
| financial_info | string | Y 이면 법인의 기업재무정보(최근 3개 사업연도 요약재무제표, 최근 사업연도 재무상태표·손익계산서)를 기업재무정보 필드에 함께 반환합니다. 법인만 제공되며 추가 요금은 없습니다. 재무정보가 없으면 기업재무정보.조회결과=N 과 사유코드를 반환합니다. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"biz_no"
],
"properties": {
"biz_no": {
"type": "string",
"description": "사업자등록번호 (숫자 10자리, 하이픈 제외, 예: 1234567890)"
},
"financial_info": {
"enum": [
"Y",
"N"
],
"type": "string",
"description": "Y 이면 법인의 기업재무정보(최근 3개 사업연도 요약재무제표, 최근 사업연도 재무상태표·손익계산서)를 기업재무정보 필드에 함께 반환합니다. 법인만 제공되며 추가 요금은 없습니다. 재무정보가 없으면 기업재무정보.조회결과=N 과 사유코드를 반환합니다."
}
}
}Look up a Korean building register by parcel number or lot address. PNU 또는 시군구·법정동·번지로 표제부·총괄표제부·기본개요·층별개요·전유부·전유공용면적·주택가격·오수정화시설·부속지번·지역지구구역을 조회합니다. PNU(19자리) 또는 sigunguCd·bjdongCd 중 하나가 필요합니다. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| ji | string | 부번 (기본 0000) |
| bun | string | 본번. 숫자만 보내면 4자리로 채웁니다. |
| pnu | string | 필지고유번호 19자리. 주면 번지 항목은 무시합니다. |
| hoNm | string | 호 이름. floor·expos·area·price 전용 |
| type | string | 대장 종류 (기본 title) |
| flrNo | integer | 층 번호. area 전용. 지하는 음수 |
| dongNm | string | 동 이름. floor·expos·area·price 전용 |
| pageNo | integer | 쪽 번호 (기본 1) |
| endDate | string | 대장 생성일 범위 끝. title·recap 전용. 연·월만 보내면 그 달 마지막 날로 맞춥니다. |
| bjdongCd | string | 법정동코드 5자리 (pnu 가 없을 때) |
Validate email syntax, MX availability, and free or disposable domain status. 이메일 형식, MX 수신 가능 여부, 무료·일회용 메일 여부를 검사합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| email* | string | 이메일 주소 (예: [email protected]) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "이메일 주소 (예: [email protected])"
}
}
}Validate and format a phone number and check the carrier and line type. 전화번호 형식 검사와 통신사·회선유형 확인을 함께 제공합니다. [호출당 40포인트]
| Argument | Type | Description |
|---|---|---|
| number* | string | 전화번호 (예: 01012341234, 해외는 +국가코드 형식) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"number"
],
"properties": {
"number": {
"type": "string",
"description": "전화번호 (예: 01012341234, 해외는 +국가코드 형식)"
}
}
}Check whether a phone number has been reported for spam, advertising, or criminal use in Korea. 스팸/광고/범죄에 사용된 전화번호인지 조회합니다. 수신 전화 필터링, 이상 거래 탐지 등에 사용합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| number* | string | 전화번호 (예: 01012341234) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"number"
],
"properties": {
"number": {
"type": "string",
"description": "전화번호 (예: 01012341234)"
}
}
}Get a company financial package by corporate registration number and year. 요약재무제표·재무상태표·손익계산서를 한 번에 조회하고 부채비율·영업이익률·ROA·ROE·전년 대비 성장률을 계산해 돌려줍니다. [호출당 100포인트]
| Argument | Type | Description |
|---|---|---|
| crno* | string | 법인등록번호 (13자리, 하이픈 없이) |
| type | string | 조회 항목 (기본 all=통합) |
| scope | string | 연결·별도 구분 (기본 all) |
| bizYear | string | 사업연도 (YYYY, 생략하면 가장 최근 연도) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"crno"
],
"properties": {
"crno": {
"type": "string",
"description": "법인등록번호 (13자리, 하이픈 없이)"
},
"type": {
"enum": [
"all",
"summary",
"balance",
"income"
],
"type": "string",
"description": "조회 항목 (기본 all=통합)"
},
"scope": {
"enum": [
"all",
"consolidated",
"separate"
],
"type": "string",
"description": "연결·별도 구분 (기본 all)"
},
"bizYear": {
"type": "string",
"description": "사업연도 (YYYY, 생략하면 가장 최근 연도)"
}
}
}Look up a Korean court auction case by case number and court. 법원 경매 사건번호와 법원(이름·코드)으로 사건 기본정보·매각기일·감정평가액·최저매각가격·진행상태를 조회합니다. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| court* | string | 법원 이름 또는 법원 코드 (예: 서울중앙지방법원) |
| case_no* | string | 사건번호 (예: 2024타경12345) — 연도·사건부호·번호 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"case_no",
"court"
],
"properties": {
"court": {
"type": "string",
"description": "법원 이름 또는 법원 코드 (예: 서울중앙지방법원)"
},
"case_no": {
"type": "string",
"description": "사건번호 (예: 2024타경12345) — 연도·사건부호·번호"
}
}
}Return ranked Korean address candidates for a partial input, merging road-name and jibun results. 입력 중인 주소의 도로명·지번 후보를 합쳐 일치도 순으로 제안합니다. 주소 입력 화면의 자동완성에 씁니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| size | integer | 후보 수 (기본 5, 최대 10) |
| query* | string | 입력 중인 주소 (예: 테헤란로) |
| category | string | 검색 범위 (기본 auto) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"size": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "후보 수 (기본 5, 최대 10)"
},
"query": {
"type": "string",
"maxLength": 50,
"description": "입력 중인 주소 (예: 테헤란로)"
},
"category": {
"enum": [
"auto",
"road",
"parcel"
],
"type": "string",
"description": "검색 범위 (기본 auto)"
}
}
}Score a list of Korean addresses for validity and completeness, grade them, and suggest alternatives for addresses that fail. 주소 목록의 유효성·완성도를 점수와 등급으로 진단하고, 찾지 못한 주소에는 대안 후보를 최대 3건 제시합니다. 고객 주소 데이터 정제에 씁니다. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| addrType | string | 주소 유형 (기본 auto) |
| addresses* | array | 진단할 주소 목록 (최대 20건) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"addresses"
],
"properties": {
"addrType": {
"enum": [
"auto",
"parcel",
"road"
],
"type": "string",
"description": "주소 유형 (기본 auto)"
},
"addresses": {
"type": "array",
"items": {},
"description": "진단할 주소 목록 (최대 20건)"
}
}
}Search Korean road-name and jibun addresses and return standardized text, parcel number, region code and coordinates. 도로명·지번 주소를 검색해 표준 주소, 필지번호, 지역코드, 좌표로 정리합니다. 도로명과 지번 결과를 합쳐 중복을 제거합니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| page | integer | 페이지 번호 (기본 1) |
| size | integer | 페이지당 결과 수 (기본 10, 최대 20) |
| query* | string | 검색어 (예: 테헤란로 152) |
| category | string | 검색 범위 (기본 auto) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "페이지 번호 (기본 1)"
},
"size": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "페이지당 결과 수 (기본 10, 최대 20)"
},
"query": {
"type": "string",
"maxLength": 100,
"description": "검색어 (예: 테헤란로 152)"
},
"category": {
"enum": [
"auto",
"road",
"parcel"
],
"type": "string",
"description": "검색 범위 (기본 auto)"
}
}
}Extract administrative names and codes (sido, sigungu, eupmyeondong, admin dong, lawd code) from an address or coordinates. 주소나 좌표에서 시도·시군구·읍면동·행정동 이름과 법정동코드·지역코드를 뽑습니다. lawdCd 는 실거래가 조회에 쓰는 지역코드입니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| x | number | 경도 |
| y | number | 위도 |
| point | string | 좌표 문자열 "경도,위도" |
| address | string | 주소. 좌표와 둘 중 하나는 필요합니다. |
| addrType | string | 주소 유형 (기본 auto) |
| includeZipcode | boolean | 우편번호 포함 여부 (기본 true) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"x": {
"type": "number",
"description": "경도"
},
"y": {
"type": "number",
"description": "위도"
},
"point": {
"type": "string",
"description": "좌표 문자열 \"경도,위도\""
},
"address": {
"type": "string",
"description": "주소. 좌표와 둘 중 하나는 필요합니다."
},
"addrType": {
"enum": [
"auto",
"parcel",
"road"
],
"type": "string",
"description": "주소 유형 (기본 auto)"
},
"includeZipcode": {
"type": "boolean",
"description": "우편번호 포함 여부 (기본 true)"
}
}
}Geocode a list of Korean addresses at once, deduplicating repeats and summarizing successes and failures. 주소 목록을 중복 제거해 최대 50건까지 한 번에 좌표·필지번호·행정코드로 바꾸고 성공·실패를 요약합니다. 엑셀·DB에 쌓인 주소를 한 번에 정리할 때 씁니다. [호출당 40포인트]
| Argument | Type | Description |
|---|---|---|
| dedupe | boolean | 중복 주소를 한 번만 조회 (기본 true) |
| addrType | string | 주소 유형 (기본 auto) |
| addresses* | array | 주소 목록. 최대 50건 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"addresses"
],
"properties": {
"dedupe": {
"type": "boolean",
"description": "중복 주소를 한 번만 조회 (기본 true)"
},
"addrType": {
"enum": [
"auto",
"parcel",
"road"
],
"type": "string",
"description": "주소 유형 (기본 auto)"
},
"addresses": {
"type": "array",
"items": {},
"description": "주소 목록. 최대 50건"
}
}
}Decide whether two Korean addresses refer to the same parcel or building, with distance and text similarity. 두 주소를 각각 좌표로 바꿔 같은 필지·같은 건물인지, 거리와 유사도는 얼마인지 판정합니다. 고객·거래처 주소 중복 정리에 씁니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| addrType | string | 주소 유형 (기본 auto) |
| addressA* | string | 첫 번째 주소 |
| addressB* | string | 두 번째 주소 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"addressA",
"addressB"
],
"properties": {
"addrType": {
"enum": [
"auto",
"parcel",
"road"
],
"type": "string",
"description": "주소 유형 (기본 auto)"
},
"addressA": {
"type": "string",
"maxLength": 200,
"description": "첫 번째 주소"
},
"addressB": {
"type": "string",
"maxLength": 200,
"description": "두 번째 주소"
}
}
}Look up an administrative district boundary and compute its area, perimeter, centroid and bounding box with an optional simplified GeoJSON. 시도·시군구·읍면동 경계를 받아 면적·둘레·중심점·경계 상자를 계산하고 단순화한 GeoJSON 을 돌려줍니다. 정점이 3000개를 넘으면 자동으로 단순화합니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| level | string | 행정구역 단계. 생략하면 이름으로 추정합니다. |
| query* | string | 행정구역 이름 또는 코드 (예: 강남구, 11680) |
| simplify | number | 단순화 허용 오차(m) |
| includeGeometry | boolean | 단순화한 경계 포함 여부 (기본 true) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"level": {
"enum": [
"L1",
"L2",
"L3",
"L4"
],
"type": "string",
"description": "행정구역 단계. 생략하면 이름으로 추정합니다."
},
"query": {
"type": "string",
"maxLength": 60,
"description": "행정구역 이름 또는 코드 (예: 강남구, 11680)"
},
"simplify": {
"type": "number",
"description": "단순화 허용 오차(m)"
},
"includeGeometry": {
"type": "boolean",
"description": "단순화한 경계 포함 여부 (기본 true)"
}
}
}Compute area, perimeter, centroid and bounding box of GeoJSON, check whether a point is inside, and return a simplified boundary. GeoJSON 의 면적·둘레·중심점·경계 상자를 계산하고, 지정점 포함 여부와 단순화 경계를 돌려줍니다. 면적은 m²·평·km² 로 함께 제공합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| x | number | 확인점 경도 |
| y | number | 확인점 위도 |
| point | string | 포함 여부를 확인할 점 "경도,위도" |
| geojson* | object | GeoJSON 객체 (Polygon·MultiPolygon·Feature·FeatureCollection, 1MB 이하) |
| simplify | number | 단순화 허용 오차(m). 0 이면 단순화하지 않습니다. |
| includeGeometry | boolean | 단순화한 도형 포함 여부 (기본 true) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"geojson"
],
"properties": {
"x": {
"type": "number",
"description": "확인점 경도"
},
"y": {
"type": "number",
"description": "확인점 위도"
},
"point": {
"type": "string",
"description": "포함 여부를 확인할 점 \"경도,위도\""
},
"geojson": {
"type": "object",
"description": "GeoJSON 객체 (Polygon·MultiPolygon·Feature·FeatureCollection, 1MB 이하)",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"simplify": {
"type": "number",
"description": "단순화 허용 오차(m). 0 이면 단순화하지 않습니다."
},
"includeGeometry": {
"type": "boolean",
"description": "단순화한 도형 포함 여부 (기본 true)"
}
}
}Measure segment distances, bearings, total length, polygon area, perimeter, centroid and bounding box from a coordinate list. 좌표 목록의 구간 거리·방위·총길이와 폐합 면적·중심점·경계 상자를 계산합니다. 지도에서 그린 경로나 필지 좌표를 바로 측량할 때 씁니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| mode | string | path 길이(기본), polygon 면적·둘레·중심점 |
| unit | string | 거리 단위 (기본 m) |
| matrix | boolean | 지점 간 거리 행렬 포함 여부 |
| coordinates* | array | 좌표 목록 (최대 200개). ["127.025,37.504", ...] 또는 [[경도,위도], ...] |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"coordinates"
],
"properties": {
"mode": {
"enum": [
"path",
"polygon"
],
"type": "string",
"description": "path 길이(기본), polygon 면적·둘레·중심점"
},
"unit": {
"enum": [
"m",
"km"
],
"type": "string",
"description": "거리 단위 (기본 m)"
},
"matrix": {
"type": "boolean",
"description": "지점 간 거리 행렬 포함 여부"
},
"coordinates": {
"type": "array",
"items": {},
"description": "좌표 목록 (최대 200개). [\"127.025,37.504\", ...] 또는 [[경도,위도], ...]"
}
}
}Analyze daily-life facilities around an address or coordinate by category, with nearest lists and average distance within a radius. 기준 주소·좌표 반경 안의 편의점·지하철역·학교·병원·약국 등을 분류별로 찾아 가까운 순서와 평균 거리로 요약합니다. 상권·입지 분석에 씁니다. [호출당 40포인트]
| Argument | Type | Description |
|---|---|---|
| x | number | 기준점 경도 |
| y | number | 기준점 위도 |
| limit | integer | 분류별 가까운 시설 수 (기본 5, 최대 10) |
| point | string | 기준점 "경도,위도" |
| radius | number | 반경(m). 기본 500 |
| address | string | 기준 주소. 좌표와 둘 중 하나는 필요합니다. |
| categories | array | 분류 이름 목록 (최대 6개). 생략하면 편의점·지하철역·학교·병원·약국 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"x": {
"type": "number",
"description": "기준점 경도"
},
"y": {
"type": "number",
"description": "기준점 위도"
},
"limit": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "분류별 가까운 시설 수 (기본 5, 최대 10)"
},
"point": {
"type": "string",
"description": "기준점 \"경도,위도\""
},
"radius": {
"type": "number",
"maximum": 2000,
"minimum": 100,
"description": "반경(m). 기본 500"
},
"address": {
"type": "string",
"description": "기준 주소. 좌표와 둘 중 하나는 필요합니다."
},
"categories": {
"type": "array",
"items": {},
"description": "분류 이름 목록 (최대 6개). 생략하면 편의점·지하철역·학교·병원·약국"
}
}
}Search places by name and enrich each result with category hierarchy, addresses, distance and bearing from an origin. 장소명으로 검색해 분류·주소·좌표를 정리하고, 기준점이 있으면 각 결과의 거리와 방위를 계산해 가까운 순으로 정렬합니다. radius 로 반경 밖 결과를 제외합니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| x | number | 기준점 경도. origin 대신 사용합니다. |
| y | number | 기준점 위도. origin 대신 사용합니다. |
| page | integer | 페이지 번호 (기본 1) |
| size | integer | 페이지당 결과 수 (기본 10, 최대 20) |
| sort | string | 정렬 (기본 distance, 기준점이 있을 때만 적용) |
| query* | string | 장소 검색어 |
| origin | string | 기준점 "경도,위도" (예: 127.025,37.504) |
| radius | number | 반경(m), 1~5000. 주면 반경 밖 결과를 제외합니다. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"x": {
"type": "number",
"description": "기준점 경도. origin 대신 사용합니다."
},
"y": {
"type": "number",
"description": "기준점 위도. origin 대신 사용합니다."
},
"page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "페이지 번호 (기본 1)"
},
"size": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "페이지당 결과 수 (기본 10, 최대 20)"
},
"sort": {
"enum": [
"distance",
"relevance"
],
"type": "string",
"description": "정렬 (기본 distance, 기준점이 있을 때만 적용)"
},
"query": {
"type": "string",
"maxLength": 100,
"description": "장소 검색어"
},
"origin": {
"type": "string",
"description": "기준점 \"경도,위도\" (예: 127.025,37.504)"
},
"radius": {
"type": "number",
"description": "반경(m), 1~5000. 주면 반경 밖 결과를 제외합니다."
}
}
}Convert coordinates into jibun and road addresses, postal code and administrative codes. 경위도 좌표를 지번·도로명 주소, 우편번호, 법정동·행정동 코드로 바꿉니다. 지도에서 고른 지점의 주소와 행정구역을 바로 확인할 때 씁니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| x | number | 경도 (-180~180). point 를 쓰지 않을 때 필요합니다. |
| y | number | 위도 (-90~90). point 를 쓰지 않을 때 필요합니다. |
| point | string | 좌표 문자열 "경도,위도" (예: 127.025,37.504) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"x": {
"type": "number",
"description": "경도 (-180~180). point 를 쓰지 않을 때 필요합니다."
},
"y": {
"type": "number",
"description": "위도 (-90~90). point 를 쓰지 않을 때 필요합니다."
},
"point": {
"type": "string",
"description": "좌표 문자열 \"경도,위도\" (예: 127.025,37.504)"
}
}
}Normalize a Korean address into standard jibun/road text, administrative codes, coordinates and postal code in one response. 지번·도로명 주소를 표준 표기, 법정동·행정동·지역 코드, 좌표, 우편번호로 한 번에 분해합니다. 주소 대신 19자리 필지번호를 주면 좌표 조회 없이 코드만 만듭니다. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| pnu | string | 필지번호 19자리. 주면 좌표 조회 없이 코드와 지번만 만듭니다. |
| address | string | 지번 또는 도로명 주소. pnu 와 둘 중 하나는 필요합니다. |
| addrType | string | 주소 유형 (기본 auto) |
| includeZipcode | boolean | 우편번호 포함 여부 (기본 true) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"pnu": {
"type": "string",
"pattern": "^[0-9]{19}$",
"description": "필지번호 19자리. 주면 좌표 조회 없이 코드와 지번만 만듭니다."
},
"address": {
"type": "string",
"description": "지번 또는 도로명 주소. pnu 와 둘 중 하나는 필요합니다."
},
"addrType": {
"enum": [
"auto",
"parcel",
"road"
],
"type": "string",
"description": "주소 유형 (기본 auto)"
},
"includeZipcode": {
"type": "boolean",
"description": "우편번호 포함 여부 (기본 true)"
}
}
}req_business_cert_bundle의 transactionId로 승인 상태와 사업자 증빙서류 통합발급 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 증명마다 result.businessRegistrationCert·result.vatTaxBaseCert·result.financialStatementCert에 따로 있습니다. 일부만 발급되면 status가 PARTIAL_SUCCESS이며 결과 단가는 그대로 청구되고, resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 126P (사업자등록증명·과세표준증명·표준재무제표증명 3종 묶음); 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_business_cert_bundle 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_business_cert_bundle 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}Check whether a Korean vehicle has a flood damage record, by VIN or license plate number. 차대번호(VIN) 또는 차량번호로 자동차의 침수 이력 여부를 조회합니다. 중고차 구매 전 확인 등에 사용합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| type* | string | 조회 종류. 1: 차대번호(VIN), 2: 차량번호 |
| value* | string | 차대번호(type=1, 17자리) 또는 차량번호(type=2) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"type",
"value"
],
"properties": {
"type": {
"type": "string",
"description": "조회 종류. 1: 차대번호(VIN), 2: 차량번호"
},
"value": {
"type": "string",
"description": "차대번호(type=1, 17자리) 또는 차량번호(type=2)"
}
}
}Check whether a Korean vehicle has a scrap/total-loss accident record, by VIN or license plate number. 차대번호(VIN) 또는 차량번호로 폐차사고처리 여부를 조회합니다. 중고차 구매 전 확인 등에 사용합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| type* | string | 조회 종류. 1: 차대번호(VIN), 2: 차량번호 |
| value* | string | 차대번호(type=1, 17자리) 또는 차량번호(type=2) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"type",
"value"
],
"properties": {
"type": {
"type": "string",
"description": "조회 종류. 1: 차대번호(VIN), 2: 차량번호"
},
"value": {
"type": "string",
"description": "차대번호(type=1, 17자리) 또는 차량번호(type=2)"
}
}
}req_cash_receipt_deduction의 transactionId로 승인 상태와 현금영수증 소득공제 내역 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 result.cashReceiptDeduction에 있으며 resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 60P × (1 + 0.5 × (incomeYears - 1)), 기본 60P; 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_cash_receipt_deduction 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_cash_receipt_deduction 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}req_driving_license의 transactionId로 승인 상태와 운전면허 조회 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 result.drivingLicense에 있으며 resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 반환 시 조회 범위별 과금, 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_driving_license 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_driving_license 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}req_employment의 transactionId로 승인 상태와 재직·보험료 확인 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 result.employment에 있으며 resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 반환 시 조회 범위별 과금, 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_employment 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_employment 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}req_health_checkup의 transactionId로 승인 상태와 국가 건강검진 결과 조회 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 result.healthCheckup에 있으며 resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 반환 시 조회 범위별 과금, 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_health_checkup 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_health_checkup 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}req_income_cert_bundle의 transactionId로 승인 상태와 소득 증빙서류 통합발급 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 증명마다 result.incomeAmountCert·result.pensionCreditCert에 따로 있습니다. 일부만 발급되면 status가 PARTIAL_SUCCESS이며 결과 단가는 그대로 청구되고, resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 84P (소득금액증명·공제확인서 2종 묶음); 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_income_cert_bundle 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_income_cert_bundle 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}req_nps_career_history의 transactionId로 승인 상태와 국민연금 경력 이력 조회 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 result.npsCareerHistory에 있으며 resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 반환 시 조회 범위별 과금, 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_nps_career_history 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_nps_career_history 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}req_nps_deduction_cert의 transactionId로 승인 상태와 국민연금 소득공제용 납부확인서 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 result.npsDeductionCert에 있으며 resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 60P × (1 + 0.5 × (years - 1)), 기본 60P; 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_nps_deduction_cert 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_nps_deduction_cert 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}req_nps_join_history의 transactionId로 승인 상태와 국민연금 가입내역 조회 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 result.npsJoinHistory에 있으며 resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 반환 시 조회 범위별 과금, 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_nps_join_history 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_nps_join_history 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}Retrieve a Korean Personal Customs Clearance Code (PCCC) by transaction ID. req_pccc 로 받은 tx_id 를 입력하면 처리 상태를 확인합니다. 아직 승인 전이면 status 는 pending, message 는 "인증 대기중입니다." 이며 과금되지 않습니다. 승인이 끝나면 개인통관고유부호·주소와 함께 조회 완료 시각 checked_at 을 반환하며 이때 과금됩니다. 조회는 정상 처리됐지만 발급된 부호가 없으면 message 는 "조회된 개인통관고유부호가 없습니다." 이고 과금되지 않습니다. 결과는 24시간 동안 재조회할 수 있고 재조회할 때마다 과금됩니다. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| tx_id* | string | req_pccc 응답의 트랜잭션 ID |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tx_id"
],
"properties": {
"tx_id": {
"type": "string",
"description": "req_pccc 응답의 트랜잭션 ID"
}
}
}req_personal_income의 transactionId로 승인 상태와 금융소득(이자·배당) 조회 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 result.personalIncome에 있으며 resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 반환 시 조회 범위별 과금, 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_personal_income 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_personal_income 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}req_tax_return_history의 transactionId로 승인 상태와 국세 신고내역 조회 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 result.taxReturnHistory에 있으며 resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 60P × (1 + 0.5 × (years - 1)), 기본 60P; 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_tax_return_history 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_tax_return_history 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}Check whether a Korean vehicle has unpaid expressway (Hi-pass) tolls by plate number. 차량번호로 고속도로 통행료 미납 대상 여부와 미납 건수를 조회합니다. 미납이 없으면(unpaid_target=false) 과금되지 않습니다. 미납 금액·통행 내역은 제공하지 않습니다. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| car_no* | string | 차량번호. 예: 12가3456, 서울12가3456 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"car_no"
],
"properties": {
"car_no": {
"type": "string",
"description": "차량번호. 예: 12가3456, 서울12가3456"
}
}
}Look up Korean public holidays for a given year and month. 해당 년월의 대한민국 공휴일 정보를 조회합니다. 영업일 계산, 일정 관리 등에 사용합니다. [호출당 3포인트]
| Argument | Type | Description |
|---|---|---|
| year* | string | 조회 년도 (1900 ~ 2200, 예: 2024) |
| month* | string | 조회 월 (1 ~ 12, 예: 02) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"year",
"month"
],
"properties": {
"year": {
"type": "string",
"description": "조회 년도 (1900 ~ 2200, 예: 2024)"
},
"month": {
"type": "string",
"description": "조회 월 (1 ~ 12, 예: 02)"
}
}
}Check your APICK account balance and status. 현재 인증 키에 연결된 APICK 계정의 잔여 포인트와 계정 상태 정보를 조회합니다. 무료입니다. [무료]
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Look up real estate transaction price records in Korea by region, property type, and year. 시/도·시/군/구, 부동산 유형, 년도를 지정해 부동산 실거래 이력을 조회합니다. addr1 값이 잘못되면 응답의 options 필드로 선택 가능한 지역 목록을 안내합니다. [호출당 100포인트]
| Argument | Type | Description |
|---|---|---|
| type* | string | 유형 코드 A~H 중 하나. A:아파트, B:연립/다세대, C:단독/다가구, D:오피스텔, E:분양/입주권, F:상업/업무용, G:토지, H:공장/창고등 |
| year* | string | 조회 년도 (1950 ~ 현재 년도, 예: 2025) |
| addr1* | string | 도/광역시/특별시 정식 명칭 (예: 서울특별시, 경기도, 부산광역시) |
| addr2* | string | 시/군/구 (예: 금천구) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"addr1",
"addr2",
"type",
"year"
],
"properties": {
"type": {
"type": "string",
"description": "유형 코드 A~H 중 하나. A:아파트, B:연립/다세대, C:단독/다가구, D:오피스텔, E:분양/입주권, F:상업/업무용, G:토지, H:공장/창고등"
},
"year": {
"type": "string",
"description": "조회 년도 (1950 ~ 현재 년도, 예: 2025)"
},
"addr1": {
"type": "string",
"description": "도/광역시/특별시 정식 명칭 (예: 서울특별시, 경기도, 부산광역시)"
},
"addr2": {
"type": "string",
"description": "시/군/구 (예: 금천구)"
}
}
}Track a Korean parcel in real time by carrier code and tracking number. 택배사 코드와 운송장번호를 지정해 실시간 배송현황을 조회합니다. carrier 코드 예: cj(CJ대한통운), hanjin(한진택배), lotte(롯데택배), logen(로젠택배), epost-domestic(우체국택배) 등 — 전체 목록은 /rest/parcel_tracking_carriers(무료)에서 확인할 수 있고, 택배사를 모르면 parcel_tracking_auto Tool로 자동판별 조회하세요. [호출당 5포인트]
| Argument | Type | Description |
|---|---|---|
| carrier* | string | 택배사 코드 (예: cj, hanjin, lotte, logen, epost-domestic) |
| trackingNumber* | string | 운송장번호 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"carrier",
"trackingNumber"
],
"properties": {
"carrier": {
"type": "string",
"description": "택배사 코드 (예: cj, hanjin, lotte, logen, epost-domestic)"
},
"trackingNumber": {
"type": "string",
"description": "운송장번호"
}
}
}Track a Korean parcel in real time with automatic carrier detection from the tracking number alone. 택배사 지정 없이 운송장번호만으로 택배사를 자동 판별해 실시간 배송현황을 조회합니다. 택배사를 이미 아는 경우에는 parcel_tracking Tool이 더 정확합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| trackingNumber* | string | 운송장번호 (택배사 지정 없이 형식만으로 자동 판별) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"trackingNumber"
],
"properties": {
"trackingNumber": {
"type": "string",
"description": "운송장번호 (택배사 지정 없이 형식만으로 자동 판별)"
}
}
}View and issue a corporate registry certificate in one call. 법인등록번호로 열람·발급을 끝내고 PDF 를 돌려줍니다(보통 10초 이내). 건당 850P(PDF 전송 포함). 결제 전에 실패하면 차감하지 않습니다. PDF 확보가 늦으면 job_id와 함께 preparing 응답이 오며, 같은 idempotency_key로 다시 호출하면 PDF를 받습니다. [호출당 850포인트]
| Argument | Type | Description |
|---|---|---|
| index | integer | 검색 결과 행 번호(1부터), 기본 1 |
| usage | string | 열람(view)·발급(issue), 기본 view |
| biz_no | string | 사업자등록번호 10자리(corp_reg_no가 없을 때) |
| corp_reg_no | string | 법인등록번호 13자리 |
| idempotency_key | string | 중복 결제 방지 키. 같은 키로 다시 호출하면 기존 작업의 PDF를 받습니다 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"index": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "검색 결과 행 번호(1부터), 기본 1"
},
"usage": {
"enum": [
"view",
"issue"
],
"type": "string",
"description": "열람(view)·발급(issue), 기본 view"
},
"biz_no": {
"type": "string",
"pattern": "^[0-9]{10}$",
"description": "사업자등록번호 10자리(corp_reg_no가 없을 때)"
},
"corp_reg_no": {
"type": "string",
"pattern": "^[0-9]{13}$",
"description": "법인등록번호 13자리"
},
"idempotency_key": {
"type": "string",
"maxLength": 128,
"minLength": 8,
"description": "중복 결제 방지 키. 같은 키로 다시 호출하면 기존 작업의 PDF를 받습니다"
}
}
}Find corporate registry targets in Korea by 13-digit corporate registration number or 10-digit business number. 법인등록번호 또는 사업자등록번호로 법인 등기 대상을 찾습니다. 개인사업자·미등록이면 결과가 없고 0P입니다. [호출당 40포인트]
| Argument | Type | Description |
|---|---|---|
| biz_no | string | 사업자등록번호 10자리(하이픈 제외). corp_reg_no가 없을 때 사용 |
| corp_reg_no | string | 법인등록번호 13자리(하이픈 제외) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"biz_no": {
"type": "string",
"pattern": "^[0-9]{10}$",
"description": "사업자등록번호 10자리(하이픈 제외). corp_reg_no가 없을 때 사용"
},
"corp_reg_no": {
"type": "string",
"pattern": "^[0-9]{13}$",
"description": "법인등록번호 13자리(하이픈 제외)"
}
}
}Verify an issued Korean registration certificate by the verification number printed on it. 증명서에 인쇄된 발급확인번호(12자리)로 발급 사실과 증명서 종류·발급일·등기소를 확인합니다. kind: realestate 부동산(기본), corporate 법인, movable 동산·채권담보. 증명서 원문은 돌려주지 않습니다. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| kind | string | 문서 종류 (기본 realestate) |
| issue_no* | string | 발급확인번호 12자리. 하이픈·공백 표기도 받습니다 (예: 2024-1234-5678) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"issue_no"
],
"properties": {
"kind": {
"enum": [
"realestate",
"corporate",
"movable"
],
"type": "string",
"description": "문서 종류 (기본 realestate)"
},
"issue_no": {
"type": "string",
"description": "발급확인번호 12자리. 하이픈·공백 표기도 받습니다 (예: 2024-1234-5678)"
}
}
}View and issue a real estate registry certificate in one call. 검색 결과의 대상을 지정하면 결제와 PDF 확보를 같은 호출에서 끝내고 PDF 를 돌려줍니다(보통 10초 이내). 건당 850P(PDF 전송 포함). 실패하면 포인트는 차감되지 않습니다. PDF 확보가 늦으면 pdf가 preparing인 JSON과 job_id가 오며, 같은 idempotency_key로 다시 호출하면 추가 과금 없이 PDF를 받습니다. [호출당 850포인트]
| Argument | Type | Description |
|---|---|---|
| pin | string | 부동산고유번호 14자리(선택) |
| index | integer | 검색 결과 행 번호(1부터), 기본 1 |
| query | string | 검색에 사용한 주소 또는 부동산고유번호 |
| usage | string | 열람(view)·발급(issue) 등, 기본 view |
| record_scope | string | 전부(all)·일부(part), 기본 all |
| idempotency_key | string | 중복 결제 방지 키. 같은 키로 다시 호출하면 기존 작업의 PDF를 받습니다 |
| include_cancelled | boolean | 말소사항 포함 여부, 기본 true |
| publish_resident_no | boolean | 주민등록번호 공개 여부, 기본 false |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"pin": {
"type": "string",
"pattern": "^[0-9]{14}$",
"description": "부동산고유번호 14자리(선택)"
},
"index": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "검색 결과 행 번호(1부터), 기본 1"
},
"query": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "검색에 사용한 주소 또는 부동산고유번호"
},
"usage": {
"enum": [
"view",
"issue",
"transfer-gov24",
"transfer-court"
],
"type": "string",
"description": "열람(view)·발급(issue) 등, 기본 view"
},
"record_scope": {
"enum": [
"all",
"part"
],
"type": "string",
"description": "전부(all)·일부(part), 기본 all"
},
"idempotency_key": {
"type": "string",
"maxLength": 128,
"minLength": 8,
"description": "중복 결제 방지 키. 같은 키로 다시 호출하면 기존 작업의 PDF를 받습니다"
},
"include_cancelled": {
"type": "boolean",
"description": "말소사항 포함 여부, 기본 true"
},
"publish_resident_no": {
"type": "boolean",
"description": "주민등록번호 공개 여부, 기본 false"
}
}
}Find real estate registry targets in Korea by road/lot address or 14-digit property number. 주소 또는 부동산고유번호로 등기부등본 열람·발급 대상을 찾습니다. 결과 targets의 index를 registry_realestate_jobs_create에 전달하세요. 결과가 없으면 0P입니다. [호출당 40포인트]
| Argument | Type | Description |
|---|---|---|
| query* | string | 주소(도로명·지번) 또는 부동산고유번호 14자리 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "주소(도로명·지번) 또는 부동산고유번호 14자리"
}
}
}사업자 증빙서류 통합발급을 위한 본인 간편인증을 요청합니다. 승인 한 번으로 담긴 증명 3종을 차례로 발급합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_business_cert_bundle에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [인증 발송 성공 시 20P]
| Argument | Type | Description |
|---|---|---|
| name* | string | 본인 이름 |
| year* | string | 귀속연도 4자리 (최근 5년, 예: 2025) |
| string | 수령 이메일 (선택, 생략 시 회원정보) | |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| agreed | boolean | 대표자 본인 확인 동의. bind_id 가 없으면 true 여야 접수되며, 빠지면 인증을 보내지 않고 무과금으로 거절 |
| fax_no | string | 팩스번호 (delivery=04 일 때 필수) |
| format | string | 응답 형식 (pdf=PDF base64만·json=PDF를 읽은 값만·both=둘 다, 생략 시 both). 대화형 사용은 응답이 작은 json 을 권장 |
| period | string | 부가가치세 과세표준증명 과세기간 (1=1기·2=2기·all=연간) |
| bind_id | string | 이전 사업자 조회 결과의 bind_id (같은 계정·같은 사업자등록번호, 90일 이내면 agreed 없이 접수) |
현금영수증 소득공제 내역을 위한 본인 간편인증을 요청합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_cash_receipt_deduction에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [인증 발송 성공 시 20P; 조회 범위와 무관]
| Argument | Type | Description |
|---|---|---|
| name* | string | 본인 이름 |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| incomeYears | integer | 소득공제 조회 연수 (1~3, 생략 시 1) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"incomeYears": {
"type": "integer",
"maximum": 3,
"minimum": 1,
"description": "소득공제 조회 연수 (1~3, 생략 시 1)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
}
}
}운전면허 조회를 위한 본인 간편인증을 요청합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_driving_license에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| name* | string | 본인 이름 |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
}
}
}재직·보험료 확인을 위한 본인 간편인증을 요청합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_employment에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| name* | string | 본인 이름 |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
| insuranceYears | integer | 보험료 조회 연수 (1~3, 생략 시 1) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
},
"insuranceYears": {
"type": "integer",
"maximum": 3,
"minimum": 1,
"description": "보험료 조회 연수 (1~3, 생략 시 1)"
}
}
}국가 건강검진 결과 조회를 위한 본인 간편인증을 요청합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_health_checkup에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| name* | string | 본인 이름 |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
}
}
}소득 증빙서류 통합발급을 위한 본인 간편인증을 요청합니다. 승인 한 번으로 담긴 증명 2종을 차례로 발급합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_income_cert_bundle에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [인증 발송 성공 시 20P]
| Argument | Type | Description |
|---|---|---|
| name* | string | 본인 이름 |
| year* | string | 귀속연도 4자리 (최근 5년, 예: 2025) |
| string | 수령 이메일 (선택, 생략 시 회원정보) | |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| fax_no | string | 팩스번호 (delivery=04 일 때 필수) |
| format | string | 응답 형식 (pdf=PDF base64만·json=PDF를 읽은 값만·both=둘 다, 생략 시 both). 대화형 사용은 응답이 작은 json 을 권장 |
| delivery* | string | 교부방법 (06 프린터·10 화면·04 팩스·12 전자문서지갑). 문서는 응답으로 받으므로 보통 06 |
| quantity | integer | 발급 희망 수량 (1~5, 생략 시 1) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
국민연금 경력 이력 조회를 위한 본인 간편인증을 요청합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_nps_career_history에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| to | string | 조회 종료 월 (YYYY-MM, 선택) |
| from | string | 조회 시작 월 (YYYY-MM, 선택) |
| name* | string | 본인 이름 |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider"
],
"properties": {
"to": {
"type": "string",
"pattern": "^[0-9]{4}-(0[1-9]|1[0-2])$",
"description": "조회 종료 월 (YYYY-MM, 선택)"
},
"from": {
"type": "string",
"pattern": "^[0-9]{4}-(0[1-9]|1[0-2])$",
"description": "조회 시작 월 (YYYY-MM, 선택)"
},
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
}
}
}국민연금 소득공제용 납부확인서를 위한 본인 간편인증을 요청합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_nps_deduction_cert에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [인증 발송 성공 시 20P; 조회 범위와 무관]
| Argument | Type | Description |
|---|---|---|
| name* | string | 본인 이름 |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| years | integer | 납부확인서 조회 연수 (1~5, 생략 시 1) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"years": {
"type": "integer",
"maximum": 5,
"minimum": 1,
"description": "납부확인서 조회 연수 (1~5, 생략 시 1)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
}
}
}국민연금 가입내역 조회를 위한 본인 간편인증을 요청합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_nps_join_history에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| to | string | 조회 종료 월 (YYYY-MM, 선택) |
| from | string | 조회 시작 월 (YYYY-MM, 선택) |
| name* | string | 본인 이름 |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider"
],
"properties": {
"to": {
"type": "string",
"pattern": "^[0-9]{4}-(0[1-9]|1[0-2])$",
"description": "조회 종료 월 (YYYY-MM, 선택)"
},
"from": {
"type": "string",
"pattern": "^[0-9]{4}-(0[1-9]|1[0-2])$",
"description": "조회 시작 월 (YYYY-MM, 선택)"
},
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
}
}
}Request simple authentication (KakaoTalk, Toss, PASS, etc.) to retrieve a Korean Personal Customs Clearance Code (PCCC). 이름, 생년월일, 휴대전화번호와 간편인증 방식을 입력하면 해당 휴대폰으로 인증 요청이 발송되고, 응답을 기다리지 않고 tx_id 를 즉시 반환합니다. 인증 요청이 실제 발송된 접수 시점에 과금되며, 이미 대기 중인 요청을 다시 보내면 재발송 없이 기존 tx_id 를 반환하고 과금되지 않습니다. 사용자가 휴대폰에서 승인한 뒤 get_pccc 에 tx_id 를 넣어 결과를 확인하세요. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| name* | string | 이름 |
| phone* | string | 휴대전화 번호 (본인 명의, 숫자만) |
| birthday* | string | 생년월일 8자리 (YYYYMMDD) |
| provider* | string | 간편인증 방식 (kakao, naver, toss, pass, samsung, kb, shinhan, hana, woori, ibk, nh, kakaobank, banksalad) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthday",
"phone",
"provider"
],
"properties": {
"name": {
"type": "string",
"description": "이름"
},
"phone": {
"type": "string",
"description": "휴대전화 번호 (본인 명의, 숫자만)"
},
"birthday": {
"type": "string",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"provider": {
"type": "string",
"description": "간편인증 방식 (kakao, naver, toss, pass, samsung, kb, shinhan, hana, woori, ibk, nh, kakaobank, banksalad)"
}
}
}금융소득(이자·배당) 조회를 위한 본인 간편인증을 요청합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_personal_income에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| name* | string | 본인 이름 |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| incomeYears | integer | 소득 조회 연수 (1~5, 생략 시 1) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"incomeYears": {
"type": "integer",
"maximum": 5,
"minimum": 1,
"description": "소득 조회 연수 (1~5, 생략 시 1)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
}
}
}국세 신고내역 조회를 위한 본인 간편인증을 요청합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_tax_return_history에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [인증 발송 성공 시 20P; 조회 범위와 무관]
| Argument | Type | Description |
|---|---|---|
| name* | string | 본인 이름 |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| years | integer | 신고내역 조회 연수 (1~10, 생략 시 1) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"years": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "신고내역 조회 연수 (1~10, 생략 시 1)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
}
}
}Analyze Korean rent transactions into jeonse share, deposit and monthly-rent bands, annual-rent-to-deposit ratio, renewal share, and jeonse ratio against same-complex sale prices. 지역·월별 전월세 실거래를 집계해 전세 비중, 보증금·월세 분포, 보증금 대비 연월세 비율, 갱신 계약 비중을 분석하고 같은 단지 매매가로 전세가율을 계산합니다. 응답은 summary·distribution·complexes·jeonse_ratio·insights 입니다. [호출당 50포인트]
| Argument | Type | Description |
|---|---|---|
| lawdCd* | string | 지역코드 (법정동코드 앞 5자리, 예: 11110) |
| pageNo | integer | 페이지 번호 (기본 1) |
| dealYmd* | string | 계약년월 (YYYYMM, 예: 202601) |
| numOfRows | integer | 페이지당 결과 수 (기본 10, 최대 1000) |
| includeTrade | boolean | 같은 단지 매매가와 비교한 전세가율(jeonse_ratio) 포함 여부 (기본 true) |
| propertyType | string | 부동산 유형 (기본 apt) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"lawdCd",
"dealYmd"
],
"properties": {
"lawdCd": {
"type": "string",
"pattern": "^[0-9]{5}$",
"description": "지역코드 (법정동코드 앞 5자리, 예: 11110)"
},
"pageNo": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "페이지 번호 (기본 1)"
},
"dealYmd": {
"type": "string",
"pattern": "^[0-9]{6}$",
"description": "계약년월 (YYYYMM, 예: 202601)"
},
"numOfRows": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "페이지당 결과 수 (기본 10, 최대 1000)"
},
"includeTrade": {
"type": "boolean",
"description": "같은 단지 매매가와 비교한 전세가율(jeonse_ratio) 포함 여부 (기본 true)"
},
"propertyType": {
"enum": [
"apt",
"rh",
"sh",
"offi"
],
"type": "string",
"description": "부동산 유형 (기본 apt)"
}
}
}Analyze Korean apartment sale transactions into per-complex and per-area price statistics, direct-deal and cancellation shares, and price outliers. 지역·월별 매매 실거래를 단지·면적대·가격대·층별로 집계해 ㎡당 중위가, 거래량, 직거래·해제 비중, 시세 이탈 거래를 분석합니다. 응답은 summary·distribution·complexes·anomalies·insights 이며 거래 원문 목록은 제공하지 않습니다. [호출당 50포인트]
| Argument | Type | Description |
|---|---|---|
| lawdCd* | string | 지역코드 (법정동코드 앞 5자리, 예: 11110) |
| pageNo | integer | 페이지 번호 (기본 1) |
| dealYmd* | string | 계약년월 (YYYYMM, 예: 202601) |
| numOfRows | integer | 페이지당 결과 수 (기본 10, 최대 1000) |
| propertyType | string | 부동산 유형 (기본 apt) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"lawdCd",
"dealYmd"
],
"properties": {
"lawdCd": {
"type": "string",
"pattern": "^[0-9]{5}$",
"description": "지역코드 (법정동코드 앞 5자리, 예: 11110)"
},
"pageNo": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "페이지 번호 (기본 1)"
},
"dealYmd": {
"type": "string",
"pattern": "^[0-9]{6}$",
"description": "계약년월 (YYYYMM, 예: 202601)"
},
"numOfRows": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "페이지당 결과 수 (기본 10, 최대 1000)"
},
"propertyType": {
"enum": [
"apt",
"rh",
"sh",
"offi"
],
"type": "string",
"description": "부동산 유형 (기본 apt)"
}
}
}Search Korean road-name addresses by keyword. 지번 또는 도로명 키워드로 도로명 주소를 검색합니다. 페이지당 10건씩 반환되며 total_count 필드로 전체 검색결과 개수를 확인할 수 있습니다. [호출당 2포인트]
| Argument | Type | Description |
|---|---|---|
| juso* | string | 검색할 주소 키워드 (지번, 도로명. 예: 디지털로) |
| page | string | 검색 결과 조회 페이지 (기본값 1, 페이지당 10건) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"juso"
],
"properties": {
"juso": {
"type": "string",
"description": "검색할 주소 키워드 (지번, 도로명. 예: 디지털로)"
},
"page": {
"type": "string",
"description": "검색 결과 조회 페이지 (기본값 1, 페이지당 10건)"
}
}
}Look up Korean vehicle emission certification details by emission certification number. 배출가스인증번호로 인증일·차명·제조사·제작국가·연료·배출가스차종·배기량·엔진출력·변속기·공차중량·총중량과 인증 이력을 조회합니다. 입력은 차량번호가 아니라 배출가스인증번호이며, 배출가스 등급은 제공하지 않습니다. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| cert_no* | string | 배출가스인증번호. 예: KMY-SY-13-24 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"cert_no"
],
"properties": {
"cert_no": {
"type": "string",
"description": "배출가스인증번호. 예: KMY-SY-13-24"
}
}
}Look up specifications of a Korean-market vehicle model (passenger cars and motorcycles/scooters) by brand, model name, model year and trim. 브랜드·차명·연식·등급으로 해당 차종(승용차와 오토바이·스쿠터 같은 이륜차)의 제원(배기량·연비·치수·타이어·소모품 규격 등), 사양, 등급 후보를 조회합니다. 차명 없이 부르면 브랜드·차종 목록을 돌려줍니다. 차명·등급 표기가 달라도 가장 비슷한 차종을 찾아 주며, 확신이 높으면 그 차종의 제원과 함께 추천(추천.자동선택, 추천.대안)을 알려주고 확신이 낮으면 제원 없이 후보만 알려줍니다. 제원 값은 표준 표기로만 내려갑니다(연료: 가솔린·디젤·LPG·전기·수소·하이브리드, 차체형상: 세단·SUV·MPV·스쿠터·네이키드 등, 구동방식: 전륜·후륜·2WD·AWD, 변속기: 자동 8단·DCT 7단·CVT, 에너지효율등급: 1~5등급, 여러 값은 "+"로 연결). [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| trim | string | 등급·트림. 예: 프레스티지 |
| maker | string | 브랜드. 예: 현대, 기아, BMW, 렉서스 |
| model | string | 차명 또는 자유문 검색어. 예: 파나메라 gts 4인승 19년식, PANAMERA GTS 19년, 더 뉴 K5. 차명·연식·등급·승차인원을 비교하며 적합한 제원이 없으면 미과금. 비우면 차종 목록 |
| modelYear | string | 연식. 예: 2024, 24년식. model에 포함 가능하며 별도 값과 다르면 입력 오류 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"trim": {
"type": "string",
"description": "등급·트림. 예: 프레스티지"
},
"maker": {
"type": "string",
"description": "브랜드. 예: 현대, 기아, BMW, 렉서스"
},
"model": {
"type": "string",
"description": "차명 또는 자유문 검색어. 예: 파나메라 gts 4인승 19년식, PANAMERA GTS 19년, 더 뉴 K5. 차명·연식·등급·승차인원을 비교하며 적합한 제원이 없으면 미과금. 비우면 차종 목록"
},
"modelYear": {
"type": "string",
"description": "연식. 예: 2024, 24년식. model에 포함 가능하며 별도 값과 다르면 입력 오류"
}
}
}Check whether a Korean vehicle is subject to recalls or free repair campaigns by plate number or VIN. 차량번호 또는 차대번호(VIN) 중 하나로 리콜·무상점검수리 대상 여부와 건수, 리콜별 내용·시정 기간을 조회합니다. 리콜 대상이 아니면(recall_target=false) 과금되지 않습니다. car_no 와 vin 은 둘 중 하나만 보냅니다. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| vin | string | 차대번호 17자리. 예: KMHXX00XXXX000000 (car_no 와 함께 보내지 않는다) |
| car_no | string | 차량번호. 예: 12가3456, 서울12가3456 (vin 과 함께 보내지 않는다) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"vin": {
"type": "string",
"description": "차대번호 17자리. 예: KMHXX00XXXX000000 (car_no 와 함께 보내지 않는다)"
},
"car_no": {
"type": "string",
"description": "차량번호. 예: 12가3456, 서울12가3456 (vin 과 함께 보내지 않는다)"
}
}
}Calculate the annual Korean automobile tax for a non-commercial passenger car from engine displacement and vehicle age. 비영업용 승용자동차의 배기량(cc)과 차령으로 연간 자동차세·지방교육세·합계를 계산합니다. 차령 3년차부터 매년 5%씩 최대 50%까지 경감합니다. 연납 공제·감면·영업용 차량은 계산하지 않습니다. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| cc* | integer | 배기량(cc), 50~10000 |
| year | integer | 과세연도(YYYY), 2011년부터 올해까지. 생략하면 올해 |
| car_age_years | integer | 차령(년), 0~40. 생략하면 0 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"cc"
],
"properties": {
"cc": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "배기량(cc), 50~10000"
},
"year": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "과세연도(YYYY), 2011년부터 올해까지. 생략하면 올해"
},
"car_age_years": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "차령(년), 0~40. 생략하면 0"
}
}
}Look up venture company information of a Korean business, including financial statements and investment data. 벤처기업을 대상으로 사업자 정보, 대차대조표, 손익계산서, 투자정보, 벤처기업확인정보를 조회합니다. [호출당 40포인트]
| Argument | Type | Description |
|---|---|---|
| biz_no* | string | 사업자등록번호 (숫자 10자리, 하이픈 제외) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"biz_no"
],
"properties": {
"biz_no": {
"type": "string",
"description": "사업자등록번호 (숫자 10자리, 하이픈 제외)"
}
}
}| platGbCd | string | 0 대지(기본), 1 산. 대지·산·임야 표기도 받습니다. |
| numOfRows | integer | 한 쪽 건수 (기본 20, 최대 100) |
| sigunguCd | string | 시군구코드 5자리 (pnu 가 없을 때) |
| startDate | string | 대장 생성일 범위 시작. title·recap 전용. 2024 / 2024-06 / 20240101 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"ji": {
"type": "string",
"description": "부번 (기본 0000)"
},
"bun": {
"type": "string",
"description": "본번. 숫자만 보내면 4자리로 채웁니다."
},
"pnu": {
"type": "string",
"pattern": "^[0-9]{19}$",
"description": "필지고유번호 19자리. 주면 번지 항목은 무시합니다."
},
"hoNm": {
"type": "string",
"description": "호 이름. floor·expos·area·price 전용"
},
"type": {
"enum": [
"title",
"recap",
"basis",
"floor",
"expos",
"area",
"price",
"wclf",
"jibun",
"district"
],
"type": "string",
"description": "대장 종류 (기본 title)"
},
"flrNo": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "층 번호. area 전용. 지하는 음수"
},
"dongNm": {
"type": "string",
"description": "동 이름. floor·expos·area·price 전용"
},
"pageNo": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "쪽 번호 (기본 1)"
},
"endDate": {
"type": "string",
"description": "대장 생성일 범위 끝. title·recap 전용. 연·월만 보내면 그 달 마지막 날로 맞춥니다."
},
"bjdongCd": {
"type": "string",
"pattern": "^[0-9]{5}$",
"description": "법정동코드 5자리 (pnu 가 없을 때)"
},
"platGbCd": {
"enum": [
"0",
"1"
],
"type": "string",
"description": "0 대지(기본), 1 산. 대지·산·임야 표기도 받습니다."
},
"numOfRows": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "한 쪽 건수 (기본 20, 최대 100)"
},
"sigunguCd": {
"type": "string",
"pattern": "^[0-9]{5}$",
"description": "시군구코드 5자리 (pnu 가 없을 때)"
},
"startDate": {
"type": "string",
"description": "대장 생성일 범위 시작. title·recap 전용. 2024 / 2024-06 / 20240101"
}
}
}| engl_yn |
| string |
| 영문 증명 여부 (Y/N, 생략 시 N) |
| delivery* | string | 교부방법 (06 프린터·10 화면·04 팩스·12 전자문서지갑). 문서는 응답으로 받으므로 보통 06 |
| quantity | integer | 발급 희망 수량 (1~5, 생략 시 1) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| submit_to* | string | 제출처 코드 2자리 (예: 99 기타) |
| business_no* | string | 사업자등록번호 10자리 (숫자만) |
| use_purpose* | string | 사용용도 코드 2자리 (예: 99 기타) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
| wallet_address | string | 전자문서지갑 주소 (delivery=12 일 때 필수) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider",
"business_no",
"year",
"use_purpose",
"submit_to",
"delivery"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"year": {
"type": "string",
"pattern": "^[0-9]{4}$",
"description": "귀속연도 4자리 (최근 5년, 예: 2025)"
},
"email": {
"type": "string",
"description": "수령 이메일 (선택, 생략 시 회원정보)"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"agreed": {
"type": "boolean",
"description": "대표자 본인 확인 동의. bind_id 가 없으면 true 여야 접수되며, 빠지면 인증을 보내지 않고 무과금으로 거절"
},
"fax_no": {
"type": "string",
"pattern": "^[0-9]{9,11}$",
"description": "팩스번호 (delivery=04 일 때 필수)"
},
"format": {
"enum": [
"pdf",
"json",
"both"
],
"type": "string",
"description": "응답 형식 (pdf=PDF base64만·json=PDF를 읽은 값만·both=둘 다, 생략 시 both). 대화형 사용은 응답이 작은 json 을 권장"
},
"period": {
"enum": [
"1",
"2",
"all"
],
"type": "string",
"description": "부가가치세 과세표준증명 과세기간 (1=1기·2=2기·all=연간)"
},
"bind_id": {
"type": "string",
"description": "이전 사업자 조회 결과의 bind_id (같은 계정·같은 사업자등록번호, 90일 이내면 agreed 없이 접수)"
},
"engl_yn": {
"enum": [
"Y",
"N"
],
"type": "string",
"description": "영문 증명 여부 (Y/N, 생략 시 N)"
},
"delivery": {
"enum": [
"10",
"12",
"06",
"04"
],
"type": "string",
"description": "교부방법 (06 프린터·10 화면·04 팩스·12 전자문서지갑). 문서는 응답으로 받으므로 보통 06"
},
"quantity": {
"type": "integer",
"maximum": 5,
"minimum": 1,
"description": "발급 희망 수량 (1~5, 생략 시 1)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"submit_to": {
"type": "string",
"pattern": "^[0-9]{2}$",
"description": "제출처 코드 2자리 (예: 99 기타)"
},
"business_no": {
"type": "string",
"pattern": "^[0-9]{10}$",
"description": "사업자등록번호 10자리 (숫자만)"
},
"use_purpose": {
"type": "string",
"pattern": "^[0-9]{2}$",
"description": "사용용도 코드 2자리 (예: 99 기타)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
},
"wallet_address": {
"type": "string",
"description": "전자문서지갑 주소 (delivery=12 일 때 필수)"
}
}
}| submit_to* | string | 제출처 코드 2자리 (예: 99 기타) |
| use_purpose* | string | 사용용도 코드 2자리 (예: 99 기타) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
| resno_open_yn | string | 주민등록번호 공개 여부 (Y/N) |
| amount_open_yn | string | 소득금액증명 금액 공개 여부 (Y/N) |
| wallet_address | string | 전자문서지갑 주소 (delivery=12 일 때 필수) |
| address_open_yn | string | 주소 공개 여부 (Y/N) |
| income_source_open_yn | string | 소득금액증명 소득발생처 공개 여부 (Y/N) |
| withholding_all_print_yn | string | 소득금액증명 원천징수의무자 전체 표시 (Y/N) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider",
"year",
"use_purpose",
"submit_to",
"delivery"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"year": {
"type": "string",
"pattern": "^[0-9]{4}$",
"description": "귀속연도 4자리 (최근 5년, 예: 2025)"
},
"email": {
"type": "string",
"description": "수령 이메일 (선택, 생략 시 회원정보)"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"fax_no": {
"type": "string",
"pattern": "^[0-9]{9,11}$",
"description": "팩스번호 (delivery=04 일 때 필수)"
},
"format": {
"enum": [
"pdf",
"json",
"both"
],
"type": "string",
"description": "응답 형식 (pdf=PDF base64만·json=PDF를 읽은 값만·both=둘 다, 생략 시 both). 대화형 사용은 응답이 작은 json 을 권장"
},
"delivery": {
"enum": [
"10",
"12",
"06",
"04"
],
"type": "string",
"description": "교부방법 (06 프린터·10 화면·04 팩스·12 전자문서지갑). 문서는 응답으로 받으므로 보통 06"
},
"quantity": {
"type": "integer",
"maximum": 5,
"minimum": 1,
"description": "발급 희망 수량 (1~5, 생략 시 1)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"submit_to": {
"type": "string",
"pattern": "^[0-9]{2}$",
"description": "제출처 코드 2자리 (예: 99 기타)"
},
"use_purpose": {
"type": "string",
"pattern": "^[0-9]{2}$",
"description": "사용용도 코드 2자리 (예: 99 기타)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
},
"resno_open_yn": {
"enum": [
"Y",
"N"
],
"type": "string",
"description": "주민등록번호 공개 여부 (Y/N)"
},
"amount_open_yn": {
"enum": [
"Y",
"N"
],
"type": "string",
"description": "소득금액증명 금액 공개 여부 (Y/N)"
},
"wallet_address": {
"type": "string",
"description": "전자문서지갑 주소 (delivery=12 일 때 필수)"
},
"address_open_yn": {
"enum": [
"Y",
"N"
],
"type": "string",
"description": "주소 공개 여부 (Y/N)"
},
"income_source_open_yn": {
"enum": [
"Y",
"N"
],
"type": "string",
"description": "소득금액증명 소득발생처 공개 여부 (Y/N)"
},
"withholding_all_print_yn": {
"enum": [
"Y",
"N"
],
"type": "string",
"description": "소득금액증명 원천징수의무자 전체 표시 (Y/N)"
}
}
}