Vietnam Water Bill API

Compute a domestic water bill in Vietnam: block tariffs by province, quotas per household or person, 5% VAT and the wastewater fee or drainage price.

Parameters

Example

curl "https://apibox.io.vn/v1/vn-water-bill?provider=hanoi&m3=25" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/vn-water-bill?provider=hanoi&m3=25', {
  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-water-bill?provider=hanoi&m3=25",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-water-bill?provider=hanoi&m3=25');
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

{
  "provider": "hanoi",
  "name": "Hà Nội",
  "name_vi": "Hà Nội",
  "customer": "household",
  "m3": 25,
  "quota": {
    "basis": "household",
    "households": 1
  },
  "tiers": [
    {
      "tier": 1,
      "m3": 10,
      "price": 8500,
      "amount": 85000,
      "limit": 10
    },
    {
      "tier": 2,
      "m3": 10,
      "price": 9900,
      "amount": 99000,
      "limit": 10
    },
    {
      "tier": 3,
      "m3": 5,
      "price": 16000,
      "amount": 80000,
      "limit": 10
    }
  ],
  "water_amount": 264000,
  "prices_include_vat": false,
  "amount_before_vat": 264000,
  "vat_percent": 5,
  "vat": 13200,
  "wastewater": {
    "kind": "env_fee",
    "kind_vi": "Phí bảo vệ môi trường đối với nước thải sinh hoạt",
    "percent": 10,
    "amount": 26400,
    "vat_percent": 0,
    "vat": 0,
    "ref": "NĐ 346/2025/NĐ-CP (phí bảo vệ môi trường đối với nước thải sinh hoạt, 10%)"
  },
  "total": 303600,
  "legal": [
    {
      "text": "QĐ 3541/QĐ-UBND (7/7/2023), stage 2",
      "effective_from": "2024-01-01"
    },
    {
      "text": "Luật Thuế GTGT 48/2024/QH15 (nước sạch 5%)",
      "effective_from": "2025-07-01"
    },
    {
      "text": "NĐ 346/2025/NĐ-CP (phí bảo vệ môi trường đối với nước thải)",
      "effective_from": "2026-01-01"
    }
  ],
  "coverage": [
    "hanoi",
    "hcm",
    "binh_duong",
    "da_nang",
    "da_nang_rural",
    "quang_nam",
    "hai_phong",
    "hai_phong_rural",
    "can_tho_rural"
  ],
  "disclaimer": "Reference calculation, not legal advice; check the official text and your invoice.",
  "reviewed": "2026-11-11"
}

Use cases

• Show the monthly water bill in a boarding-house or building management app
• Split utility costs between tenants
• Check a water invoice from SAWACO, Hanoi or Hải Phòng
• Estimate utility costs in a property listing

FAQ

Related APIs