Vietnam Inheritance Calculator API

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

POSThttps://apibox.io.vn/v1/vn-inheritance

Data & JSON▶ Try it online

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.

Parameters

Name	In	Type	Required
`heirs`	body	array	yes	People: `{id, name, relation, alive, minor, unable_to_work, refused, disqualified, parent}`. Relations: spouse, father, mother, child, grandparent, sibling, grandchild, great_grandparent, uncle_aunt, nephew_niece, great_grandchild (Vietnamese words such as vợ, con, ông nội also work).
`own_property`	body	number	no	Separate property of the deceased (VND). Alias `estate`.
`joint_property`	body	number	no	Joint marital property (VND); the deceased's part is `deceased_joint_share` (default 1/2).
`funeral_costs`	body	number	no	Funeral costs paid from the estate.
`debts`	body	number	no	Debts of the deceased (also `other_obligations`).
`will`	body	object	no	`{gifts: [{to, share \| amount}], disinherit: [id]}`; `to` is an heir id or the name of any other beneficiary.

Example

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

Response

{
  "method": "law",
  "estate": {
    "own_property": 0,
    "joint_property": 2000000000,
    "deceased_joint_share": "1/2",
    "deceased_part_of_joint": 1000000000,
    "surviving_spouse_part_of_joint": 1000000000,
    "gross_estate": 1000000000,
    "funeral_costs": 40000000,
    "debts": 0,
    "other_obligations": 0,
    "net_estate": 960000000
  },
  "rank_inheriting_by_law": 1,
  "heirs": [
    {
      "id": "w",
      "name": "Bà Lan",
      "relation": "spouse",
      "relation_vi": "vợ/chồng",
      "rank": 1,
      "fraction": "1/3",
      "percent": 33.3333,
      "amount": 320000000,
      "basis": [
        {
          "source": "law",
          "fraction": "1/3"
        }
      ]
    },
    {
      "id": "c1",
      "name": "Anh Minh",
      "relation": "child",
      "relation_vi": "con",
      "rank": 1,
      "fraction": "1/3",
      "percent": 33.3333,
      "amount": 320000000,
      "basis": [
        {
          "source": "law",
          "fraction": "1/3"
        }
      ]
    },
    {
      "id": "c2",
      "name": "Chị Hoa",
      "relation": "child",
      "relation_vi": "con",
      "rank": 1,
      "fraction": "0",
      "percent": 0,
      "amount": 0,
      "basis": [],
      "not_receiving_because": "died before or at the same time as the deceased"
    },
    {
      "id": "g",
      "name": "Bé Na",
      "relation": "grandchild",
      "relation_vi": "cháu (con của con)",
      "rank": 1,
      "by_representation": true,
      "fraction": "1/3",
      "percent": 33.3333,
      "amount": 320000000,
      "basis": [
        {
          "source": "law",
          "fraction": "1/3"
        }
      ]
    }
  ],
  "steps": [
    {
      "step": "obligations",
      "en": "Pay first, in the order of art. 658: funeral costs 40,000,000, debts 0, other obligations 0. Net estate to divide: 960,000,000.",
      "vi": "Thanh toán trước theo thứ tự Điều 658: chi phí mai táng 40.000.000, nợ 0, nghĩa vụ khác 0. Di sản còn lại để chia: 960.000.000."
    },
    {
      "step": "law",
      "en": "The whole estate goes to rank 1 heirs (art. 651), in equal shares: 3 share(s) of 1/3; a deceased child's share is split equally among his / her children (representation, art. 652). Higher ranks inherit only when no one of a lower rank number can (art. 651(3)).",
      "vi": "Toàn bộ di sản chia cho hàng thừa kế thứ 1 (Điều 651), mỗi người một phần bằng nhau: 3 suất, mỗi suất 1/3; suất của người con đã chết chia đều cho các con của người đó (thừa kế thế vị, Điều 652). Hàng sau chỉ được hưởng khi không còn ai ở hàng trước (Điều 651 khoản 3)."
    }
  ],
  "legal": [
    {
      "ref": "Bộ luật Dân sự 2015 (91/2015/QH13), Điều 612–662",
      "effective_from": "2017-01-01"
    },
    {
      "ref": "Luật Hôn nhân và gia đình 2014 (52/2014/QH13), Điều 66",
      "effective_from": "2015-01-01"
    }
  ],
  "notes": [
    "Illustration only: real cases depend on proof of kinship, the validity and wording of the will, the time the succession opened and court practice.",
    "Amounts are rounded to whole VND so that they add up to the net estate."
  ],
  "disclaimer": "Reference calculation, not legal advice; check the official text.",
  "disclaimer_vi": "Kết quả tham khảo, không phải tư vấn pháp lý; hãy đối chiếu văn bản chính thức.",
  "reviewed": "2026-11-11"
}

Use cases

Show families how an estate is divided when there is no will
Check whether a will respects the 2/3 compulsory share
Explain representation (thừa kế thế vị) with a worked example
Prepare figures for a notary or a law firm before the inheritance agreement

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.

Related APIs

{✓}

Vietnam Inheritance Calculator API

Parameters

Example

Response

Use cases

FAQ

Related APIs

JSON Validator

JSON Formatter

CSV to JSON