Vietnam Retirement Age API

Retirement age and date in Vietnam from birth date and sex under the NĐ 135/2020 roadmap, the reduced-age case and the pension rate by years paid.

GEThttps://apibox.io.vn/v1/vn-retirement

Data & JSON▶ Try it online

Send a birth date and sex and get the retirement age that applies (men 60 years 3 months in 2021 rising by 3 months a year to 62 in 2028; women 55 years 4 months rising by 4 months a year to 60 in 2035), the day the age is reached, the retirement date (end of that month) and the first pension month, exactly as in Phụ lục I of NĐ 135/2020/NĐ-CP.

condition=reduced applies the roadmap 5 years lower (Phụ lục II: at least 15 years of heavy or hazardous work, especially difficult areas, or ≥ 61% reduced working capacity), mining up to 10 years lower, and later the maximum 5 years later; with the normal condition the answer also shows the reduced age.

With contribution_years (or contribution_months) the API adds the pension rate of Luật BHXH 41/2024/QH15 Điều 66: 45% for 15 years (women) or 20 years (men, 40% at 15 years), +2% per extra year, up to 75%.

Parameters

Name	In	Type	Required	Default
`birth_date`	query	string	yes		Birth date (YYYY-MM-DD; YYYY-MM uses day 1).
`sex`	query	string	yes		`male` or `female`.
`condition`	query	string	no	`normal`	`normal`, `reduced`, `mining` or `later`.
`contribution_years`	query	number	no		Years of social-insurance contributions (pension rate).

Example

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));

Response

{
  "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"
}

Use cases

Warn HR when employees approach retirement
Show the retirement date in a social-insurance app
Set the maximum loan term by age in a bank app
Plan pensions in a personal finance tool

FAQ

Does the birth day matter?

Yes: the age is reached on the birth day of the month; retirement takes effect at the end of that month and the pension starts the next month.

Who is outside the scope?

Officials in some leadership posts, the armed forces and professions with their own laws. The API covers employees under the Labour Code.

Is early-retirement reduction applied to the pension rate?

No, the rate shown is for retirement at the normal age; retiring early under the reduced-age rules lowers it by 2% per year early.

Related APIs

{✓}

Vietnam Retirement Age API

Parameters

Example

Response

Use cases

FAQ

Related APIs

JSON Validator

JSON Formatter

CSV to JSON