Vietnam Electricity Bill API

Compute an EVN electricity bill: the 5-tier household tariff from 1/11/2026, VAT, prorating across a price change, business rates and room splits.

Parameters

Example

curl "https://apibox.io.vn/v1/vn-electricity?kwh=250" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/vn-electricity?kwh=250', {
  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-electricity?kwh=250",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-electricity?kwh=250');
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

{
  "customer": "household",
  "kwh": 250,
  "amount_before_vat": 563700,
  "vat_percent": 8,
  "vat": 45096,
  "total": 608796,
  "segments": [
    {
      "tariff": "QĐ 2892/QĐ-BCT",
      "effective_from": "2026-11-01",
      "kwh": 250,
      "amount": 563700,
      "tiers": [
        {
          "tier": 1,
          "kwh": 100,
          "price": 1901,
          "amount": 190100,
          "limit": 100
        },
        {
          "tier": 2,
          "kwh": 100,
          "price": 2289,
          "amount": 228900,
          "limit": 100
        },
        {
          "tier": 3,
          "kwh": 50,
          "price": 2894,
          "amount": 144700,
          "limit": 200
        }
      ]
    }
  ],
  "quota": {
    "households": 1
  },
  "tariff": {
    "decree": "QĐ 2892/QĐ-BCT",
    "effective_from": "2026-11-01",
    "tiers": [
      {
        "tier": 1,
        "kwh": 100,
        "price": 1901
      },
      {
        "tier": 2,
        "kwh": 100,
        "price": 2289
      },
      {
        "tier": 3,
        "kwh": 200,
        "price": 2894
      },
      {
        "tier": 4,
        "kwh": 300,
        "price": 3456
      },
      {
        "tier": 5,
        "kwh": null,
        "price": 3844
      }
    ]
  },
  "reviewed": "2026-11-11"
}

Use cases

• Show the monthly bill in a smart-home or energy app
• Split the bill between rooms in a boarding-house management app
• Estimate savings for a solar or ESG calculator
• Check a business bill with peak and off-peak kWh

FAQ

Related APIs