Tuổi nghỉ hưu API

Tra tuổi nghỉ hưu và thời điểm nghỉ hưu theo ngày sinh, giới tính và lộ trình NĐ 135/2020, kèm trường hợp nghỉ hưu sớm và tỷ lệ lương hưu.

Tham số

Ví dụ

curl "https://apibox.io.vn/v1/vn-retirement?birth_date=1975-08-20&sex=female&contribution_years=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/vn-retirement?birth_date=1975-08-20&sex=female&contribution_years=20', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
  },
});
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://apibox.io.vn/v1/vn-retirement?birth_date=1975-08-20&sex=female&contribution_years=20",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-retirement?birth_date=1975-08-20&sex=female&contribution_years=20');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Kết quả trả về

{
  "birth_date": "1975-08-20",
  "sex": "female",
  "condition": "normal",
  "retirement_age": {
    "years": 60,
    "months": 0,
    "text_vi": "60 tuổi"
  },
  "reaches_age_on": "2035-08-20",
  "retirement_date": "2035-08-31",
  "pension_start": "2035-09-01",
  "already_retired": false,
  "reduced_age": {
    "age": {
      "years": 52,
      "months": 4,
      "text_vi": "52 tuổi 4 tháng"
    },
    "from": "2027-12-20",
    "applies_to": "heavy / hazardous work or especially difficult areas ≥ 15 years, reduced working capacity ≥ 61% (NĐ 135/2020 Điều 5)"
  },
  "legal": "NĐ 135/2020/NĐ-CP Điều 4, Phụ lục I",
  "pension": {
    "contribution_years": 20,
    "eligible": true,
    "rate_percent": 55,
    "legal": "Luật BHXH 41/2024/QH15 Điều 64, 66 (15 years minimum; early retirement reduces the rate by 2% per year early)"
  },
  "reviewed": "2026-11-11"
}

Ứng dụng

• Cảnh báo nhân sự sắp đến tuổi nghỉ hưu trong phần mềm HRM
• Hiển thị thời điểm nghỉ hưu trong app BHXH
• Xác định thời hạn vay tối đa theo tuổi trong app ngân hàng
• Lập kế hoạch hưu trí trong app tài chính cá nhân

Hỏi đáp

API liên quan