Vietnam Inheritance Calculator

Divide an estate under the Vietnamese Civil Code 2015: heirs by rank, representation, wills, the 2/3 compulsory share, joint property. Exact fractions.

Result

Press “Run” to see the result.

Send a small family tree (heirs: spouse, parents, children, grandparents, siblings, grandchildren, uncles / aunts, nephews / nieces, great-grandchildren, with alive, minor, unable_to_work, refused, disqualified and parent links) and the property: own_property, joint_property (half of the joint marital property belongs to the deceased, Marriage and Family Law art. 66), funeral_costs, debts. The API divides the net estate step by step and explains each step in English and Vietnamese.

By law (Civil Code art. 651) the first rank that has an heir takes everything in equal shares; a child who died before the deceased is represented by his or her children (art. 652). With a will (gifts as fractions or amounts, disinherit), lapsed gifts and the undisposed part go by law, and compulsory heirs (spouse, parents, minor children, adult children unable to work) get at least two thirds of the share they would have by law (art. 644); the shortfall is taken from the other beneficiaries in proportion to their gifts. Shares are exact fractions (BigInt rationals) and amounts are rounded so that they add up to the net estate.

It is an illustration, not legal advice: proof of kinship, the validity of the will and court practice decide real cases.

Use this in your code

curl -X POST "https://apibox.io.vn/v1/vn-inheritance" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"joint_property":2000000000,"funeral_costs":40000000,"heirs":[{"id":"w","name":"Bà Lan","relation":"spouse"},{"id":"c1","name":"Anh Minh","relation":"child"},{"id":"c2","name":"Chị Hoa","relation":"child","alive":false},{"id":"g","name":"Bé Na","relation":"grandchild","parent":"c2"}]}'

const res = await fetch('https://apibox.io.vn/v1/vn-inheritance', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "joint_property": 2000000000,
    "funeral_costs": 40000000,
    "heirs": [
      {
        "id": "w",
        "name": "Bà Lan",
        "relation": "spouse"
      },
      {
        "id": "c1",
        "name": "Anh Minh",
        "relation": "child"
      },
      {
        "id": "c2",
        "name": "Chị Hoa",
        "relation": "child",
        "alive": false
      },
      {
        "id": "g",
        "name": "Bé Na",
        "relation": "grandchild",
        "parent": "c2"
      }
    ]
  }),
});
const data = await res.json();
console.log(data);

import requests

res = requests.post(
    "https://apibox.io.vn/v1/vn-inheritance",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"joint_property": 2000000000, "funeral_costs": 40000000, "heirs": [{"id": "w", "name": "Bà Lan", "relation": "spouse"}, {"id": "c1", "name": "Anh Minh", "relation": "child"}, {"id": "c2", "name": "Chị Hoa", "relation": "child", "alive": False}, {"id": "g", "name": "Bé Na", "relation": "grandchild", "parent": "c2"}]},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-inheritance');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"joint_property":2000000000,"funeral_costs":40000000,"heirs":[{"id":"w","name":"Bà Lan","relation":"spouse"},{"id":"c1","name":"Anh Minh","relation":"child"},{"id":"c2","name":"Chị Hoa","relation":"child","alive":false},{"id":"g","name":"Bé Na","relation":"grandchild","parent":"c2"}]}',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

API documentation → Get a free API key

FAQ

How is the 2/3 compulsory share computed?

As two thirds of the share the person would get if the whole net estate were divided by law among the heirs of the first rank (art. 644). If the will gives less, the difference is deducted from the other beneficiaries in proportion to their gifts.

What happens to joint marital property?

Half (or the share you set in deceased_joint_share) belongs to the deceased and enters the estate; the other half stays with the surviving spouse as his or her own property.

Who inherits if a child died before the parent?

That child's children share his or her part equally (representation, art. 652); if they also died earlier, their children do.