국민연금공단_국민연금 가입현황

(국민연금 가입현황 정보) 법정동단위 지역별, 연령대별, 성별(M:남자, F:여자), 가입종별(0:사업장, 1:지역, 2:임의계속, 5:임의가입) 가입자 통계 정보를 조회할 수 있습니다.1) 가입현황 정보조회(출력값): 평균예상연금금액, 가입내역구간인원수, 평균납부금액, 평균가입금액2) 최고값 정보조회(출력값): 최고예상연금금액, 인정최고금액, 인정최고개월수3) 연령별 정보조회(출력값): 평균예상연금금액, 인정평균금액, 인정평균개월수* 데이터 기준일 : 매월 초일** 연령 : 0 이외의 값을 입력하세요.자세한 내용은 참고문서(국민연금공단_오픈API활용가이드_국민연금 가입현황_v2.0.docx)를 활용하시기 바랍니다.

body header item items 가입기간 최고값 가입내역구간인원수 결과메세지 결과코드 납부금액 최고값 예상연금금액 최고값 전체 결과 수 페이지 번호 평균가입기간 평균납부금액 평균예상연금금액 한 페이지 결과 수

주소는 예시입니다 — 이 API의 실제 호출 주소는 공공데이터포털이 로그인 뒤에만 공개해서 자동으로 가져올 수 없습니다. 파라미터 이름은 확실하니, 주소만 원문 활용가이드에서 확인해 채우십시오.

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '0:사업장=값' \
  --data-urlencode '1:지역=값' \
  --data-urlencode '2:임의계속=값' \
  --data-urlencode '5:임의가입=값' \
  --data-urlencode 'M:남자=값' \
  --data-urlencode 'F:여자=값'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "0:사업장": "값",
  "1:지역": "값",
  "2:임의계속": "값",
  "5:임의가입": "값",
  "M:남자": "값",
  "F:여자": "값",
});

const res = await fetch(`https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

import requests

params = {
    "serviceKey": "발급받은_인증키",
    "0:사업장": "값",
    "1:지역": "값",
    "2:임의계속": "값",
    "5:임의가입": "값",
    "M:남자": "값",
    "F:여자": "값",
}

r = requests.get("https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}", params=params, timeout=15)
r.raise_for_status()
print(r.json())