Data sources & licences
Last updated: 2026-11-11
APIBox is built on open data, public legal texts and open-source libraries. This page lists every source with its licence, the endpoints that use it and how often it is refreshed. Data from external sources is rebuilt on a schedule by an automatic job and checked before it replaces the current version; a broken source never overwrites good data. When you display a result that carries an attribution or licence field, keep that credit line (for example GeoNames, OpenStreetMap, MET Norway, Copernicus).
Vietnamese administrative units and maps · Vietnamese reference data · World reference and geo data · Network, security and developer data · Fonts · Main open-source libraries · Legal and reference calculations
Vietnamese administrative units and maps
| Dataset / library | Licence | Source | Endpoints | Refresh |
|---|---|---|---|---|
| Provinces, wards and old → new conversion (after 1/7/2025) | MIT (ThangLeQuoc); official NSO table and sapnhap.bando.com.vn | github.com/ThangLeQuoc/vietnamese-provinces-database danhmuchanhchinh.nso.gov.vn | vn-provinces, address-parse, vn-postcode | Weekly, checked before replacing |
| Ward boundaries (simplified) | MIT (derived from sapnhap.bando.com.vn) | github.com/ThangLeQuoc/vietnamese-provinces-database | vn-geo | Weekly, checked before replacing |
| Street names by ward | ODbL 1.0 © OpenStreetMap contributors | www.openstreetmap.org/copyright download.geofabrik.de/asia/vietnam.html | vn-streets | Monthly |
| Terrain elevation of Vietnam (Copernicus DEM GLO-90) | Copernicus DEM licence (free use, attribution and liability notice) | copernicus-dem-90m.s3.amazonaws.com/readme.html spacedata.copernicus.eu/collections/copernicus-digital-elevation-model | elevation | Weekly check, rebuilt when the source changes |
Vietnamese reference data
| Dataset / library | Licence | Source | Endpoints | Refresh |
|---|---|---|---|---|
| VSIC 2025 / 2018 economic activity codes | Official texts (not copyrighted, IP Law art. 15) | dangkykinhdoanh.gov.vn www.nso.gov.vn | vsic | Weekly, checked before replacing |
| HS codes and import / export tariffs | Workbook of Trung tâm WTO và Hội nhập – VCCI (credited, lookup aid only) | trungtamwto.vn | hs-code, vn-import-cost | Weekly, checked before replacing |
| SWIFT / BIC of banks in Vietnam | Bank websites, VietQR bank list (facts) | api.vietqr.io/v2/banks | swift-bic, vietqr | Weekly, checked before replacing |
| Regional minimum wage by ward | Decrees 293/2025, 399/2026 (official texts) | lsvn.vn | vn-min-wage, vn-salary, vn-bhxh-forms | Weekly, checked before replacing |
| Ethnic groups, religions, VSCO occupations | CC0 (HL7 Vietnam VN Core FHIR IG), official texts | vncore-ig.pages.dev/core | vn-catalogs | Weekly, checked before replacing |
| University major codes (TT 09/2022, TT 74/2026) | Official texts | datafiles.chinhphu.vn/cpp/files/vbpq/2026/9/74-bgddt.signed.pdf | vn-majors | Weekly, checked before replacing |
| ICD-10 in Vietnamese (TT 06/2026/TT-BYT) | Official text | datafiles.chinhphu.vn/cpp/files/vbpq/2026/4/06-byt.pdf | vn-icd10, vn-bhyt-xml | Weekly, checked before replacing |
| Permitted and banned plant protection products (TT 75/2025, TT 28/2026) | Official texts (signed PDFs) | mae.gov.vn/van-ban-phap-luat-723.htm www.ppd.gov.vn | vn-pesticides | Weekly, checked before replacing |
| Vietnamese CA certificates (NEAC root, licensed CAs, Government CA) | Public certificates | rootca.gov.vn | pdf-sign-verify | Weekly, checked before replacing |
| Given names by gender | MIT | github.com/duyet/vietnamese-namedb | vn-name | Weekly, checked before replacing |
| Vietnamese word list | MIT | github.com/trungtv/pyvi | vn-tokenize, vn-spellcheck, vn-diacritics, vn-syllable, vn-teencode | Weekly, checked before replacing |
| Hán-Việt readings and Chinese dictionary | Unicode License v3 (Unihan); CC BY-SA 4.0 (Wiktionary via kaikki.org, CC-CEDICT) | www.unicode.org/charts/unihan.html kaikki.org www.mdbg.net/chinese/dictionary?page=cedict | vn-hanviet | Weekly, checked before replacing |
| Marketplace seller fees (Shopee, TikTok Shop, Lazada) | Public fee pages of the platforms (facts, hand-entered) | seller-vn.tiktok.com banhang.shopee.vn | vn-marketplace-fees | Hand-entered, review date in every answer (31–180 days) |
| Official public holidays of Vietnam | Notices of the Ministry of Home Affairs (official texts) | moha.gov.vn | vn-holidays, vn-legal-deadline | Yearly, when the new schedule is announced |
| Legal tables: tax, payroll, insurance, fees, fines, court fees, inheritance, visas, labels, water tariffs, building rules, admissions, invoices… | Laws, decrees, circulars, decisions (not copyrighted, IP Law art. 15); cited in every answer | vanban.chinhphu.vn congbao.chinhphu.vn | all Vietnamese calculators (see each page) | Hand-entered, review date in every answer (31–180 days) |
World reference and geo data
| Dataset / library | Licence | Source | Endpoints | Refresh |
|---|---|---|---|---|
| Countries, currencies, calling codes, time zones | MIT (countries-list, i18n-iso-countries); public domain (IANA tz) | github.com/annexare/Countries github.com/michaelwittig/node-i18n-iso-countries www.iana.org/time-zones | countries, vn-visa-rules | Weekly, checked before replacing |
| Public holidays of ~200 countries | CC BY-SA 4.0 (data), ISC (code) – date-holidays | github.com/commenthol/date-holidays | holidays | Weekly, checked before replacing |
| Cities ≥ 5,000 inhabitants with English / Vietnamese names | CC BY 4.0 – GeoNames | www.geonames.org download.geonames.org/export/dump | cities | Weekly, checked before replacing |
| World postal codes | CC BY 4.0 (GeoNames); OGL v3 (GB, Royal Mail / OS Code-Point Open); public domain (NL, BAG) | download.geonames.org/export/zip | world-postcodes | Weekly, checked before replacing |
| Postal-code formats of ~180 countries | CC BY 4.0 – Google Address Data Service / libaddressinput | github.com/google/libaddressinput chromium-i18n.appspot.com/ssl-address/data | world-postcodes | Weekly, checked before replacing |
| Airports and runways | Public domain – OurAirports | ourairports.com/data | airports | Weekly, checked before replacing |
| Vehicle manufacturer codes (WMI) and VIN decoding | Public domain (US government work) – NHTSA vPIC | vpic.nhtsa.dot.gov/api | vin-decode | Weekly, checked before replacing |
| UN/LOCODE | CC BY 4.0 – UNECE / UN/CEFACT | unece.org/trade/cefact/unlocode-code-list-country-and-territory | freight-codes | Weekly, checked before replacing |
| GS1 company prefixes | GS1 official list (facts), change detection via Wikipedia | www.gs1.org/standards/id-keys/company-prefix | gtin-check, gs1-parse | Weekly, checked before replacing |
| GS1 Application Identifiers and Digital Link | Apache-2.0 – GS1 Barcode Syntax Dictionary (re-typed) | github.com/gs1/gs1-syntax-dictionary ref.gs1.org/ai | gs1-parse | Hand-entered, reviewed every 180 days |
| Exchange rates | Vietcombank public rate table; open.er-api.com (attribution) | www.vietcombank.com.vn www.exchangerate-api.com | exchange-rates | Live request (short cache) |
| Weather forecasts | CC BY 4.0 – MET Norway | api.met.no | weather | Live request (short cache) |
Network, security and developer data
| Dataset / library | Licence | Source | Endpoints | Refresh |
|---|---|---|---|---|
| IP geolocation and ASN | CC BY 4.0 – DB-IP Lite | db-ip.com/db/lite.php | ip, dmarc-report | Monthly |
| Cloud, Tor and crawler IP ranges | The providers' own published files | ip-ranges.amazonaws.com/ip-ranges.json check.torproject.org/torbulkexitlist | ip-intel | Daily |
| MAC address vendors | IEEE Registration Authority public listings | standards.ieee.org/products-programs/regauth | mac-vendor | Weekly, checked before replacing |
| Public Suffix List | MPL-2.0 (list), MIT (tldts) | publicsuffix.org github.com/remusao/tldts | domain-parse, dmarc-report, email-auth | Weekly, checked before replacing |
| Disposable e-mail domains | MIT | github.com/ivolo/disposable-email-domains | email-validator | Weekly, checked before replacing |
| Pwned Passwords (k-anonymity, 5-character hash prefix only) | CC BY 4.0 – Have I Been Pwned | haveibeenpwned.com/Passwords | password-check | Live request (short cache) |
| RDAP bootstrap and WHOIS / RDAP records | IANA (public), registries | data.iana.org/rdap/dns.json | whois | Live request (short cache) |
| Vulnerability advisories | CC BY 4.0 / per source – OSV.dev (GitHub Advisory Database, PyPA, Go, RustSec…) | osv.dev | dep-audit | Live request (short cache) |
| Latest package versions (npm, PyPI, Packagist) | Public registry APIs | registry.npmjs.org pypi.org packagist.org | dep-audit | Live request (short cache) |
| SPDX licence identifiers | CC0-1.0 / Apache-2.0 / MIT (spdx-license-ids, spdx-correct, spdx-expression-parse) | github.com/jslicense | dep-audit | With the library version we ship |
| Secret detection rules | MIT – gitleaks | github.com/gitleaks/gitleaks | secret-scan | Weekly, checked before replacing |
| AI crawler list | MIT – ai.robots.txt | github.com/ai-robots-txt/ai.robots.txt | robots-txt, log-parse | Weekly, checked before replacing |
| OpenAI BPE tables (o200k_base, cl100k_base) | MIT – tiktoken via gpt-tokenizer | github.com/openai/tiktoken github.com/niieani/gpt-tokenizer | llm-tokens | Weekly, checked before replacing |
| OpenAPI / Swagger JSON Schemas | Apache-2.0 – OpenAPI Initiative | spec.openapis.org | openapi-tools | Weekly, checked before replacing |
Fonts
| Dataset / library | Licence | Source | Endpoints | Refresh |
|---|---|---|---|---|
| Be Vietnam Pro | SIL OFL 1.1 | fonts.google.com/specimen/Be+Vietnam+Pro | invoice-pdf, vn-einvoice, vn-payroll-batch, label-pdf, image-watermark, og-image, pdf-form | With the library version we ship |
| JetBrains Mono | SIL OFL 1.1 | www.jetbrains.com/lp/mono | code-image | With the library version we ship |
| STIX Two Math | SIL OFL 1.1 | www.stixfonts.org | math-render | With the library version we ship |
Main open-source libraries
| Dataset / library | Licence | Source | Endpoints | Refresh |
|---|---|---|---|---|
| pdf-lib, @pdf-lib/fontkit | MIT | github.com/Hopding/pdf-lib | invoice-pdf, pdf-tools, pdf-form, label-pdf, vn-einvoice | With the library version we ship |
| unpdf (pdf.js) | MIT / Apache-2.0 | github.com/unjs/unpdf | pdf-text, pdf-tools | With the library version we ship |
| linkedom | ISC | github.com/WebReflection/linkedom | html-to-markdown, page-watch, a11y-check, email-inline | With the library version we ship |
| @mozilla/readability, turndown, marked | Apache-2.0 / MIT / MIT | github.com/mozilla/readability github.com/mixmark-io/turndown github.com/markedjs/marked | html-to-markdown, markdown-to-html | With the library version we ship |
| axe-core | MPL-2.0 (unmodified) | github.com/dequelabs/axe-core | a11y-check | With the library version we ship |
| harfbuzzjs (hb-subset) | MIT | github.com/harfbuzz/harfbuzzjs | font-subset | With the library version we ship |
| music-metadata | MIT | github.com/borewit/music-metadata | media-metadata | With the library version we ship |
| fflate | MIT | github.com/101arrowz/fflate | archive, font-subset | With the library version we ship |
| graphql-js | MIT | github.com/graphql/graphql-js | graphql-tools | With the library version we ship |
| protobufjs, @msgpack/msgpack, cbor-x, bson | BSD-3-Clause / ISC / MIT / Apache-2.0 | github.com/protobufjs/protobuf.js github.com/msgpack/msgpack-javascript github.com/kriszyp/cbor-x github.com/mongodb/js-bson | binary-formats | With the library version we ship |
| jsdiff, croner | BSD-3-Clause / MIT | github.com/kpdecker/jsdiff github.com/hexagon/croner | page-watch, monitors, text-diff, cron | With the library version we ship |
| fast-xml-parser, yaml, papaparse | MIT / ISC / MIT | github.com/NaturalIntelligence/fast-xml-parser github.com/eemeli/yaml github.com/mholt/PapaParse | xml-convert, yaml, csv-to-json, csv-query, vn-bhyt-xml | With the library version we ship |
| zxing-wasm, jsQR, qrcode | MIT / Apache-2.0 / MIT | github.com/Sec-ant/zxing-wasm github.com/cozmo/jsQR github.com/soldair/node-qrcode | barcode-read, qr-decode, qr | With the library version we ship |
| svgo, terser, csso, sql-formatter | MIT / BSD-2-Clause / MIT / MIT | github.com/svg/svgo github.com/terser/terser | svg-tools, minify, sql-format | With the library version we ship |
| highlight.js, temml | BSD-3-Clause / MIT | github.com/highlightjs/highlight.js github.com/ronkok/Temml | code-image, math-render | With the library version we ship |
| pkijs, asn1js | BSD-3-Clause | github.com/PeculiarVentures/PKI.js | pdf-sign-verify, x509 | With the library version we ship |
| libphonenumber-js, ua-parser-js, tldts | MIT | gitlab.com/catamphetamine/libphonenumber-js github.com/faisalman/ua-parser-js | phone, user-agent, log-parse | With the library version we ship |
| jpeg-js, fast-png, exifr, blurhash, thumbhash, pixelmatch | BSD-3-Clause / MIT / MIT / MIT / MIT / ISC | github.com/eugeneware/jpeg-js github.com/image-js/fast-png | image-resize, image-metadata, image-palette, image-diff | With the library version we ship |
| mathjs, jsonrepair, @cfworker/json-schema, semver, postal-mime, franc-min | Apache-2.0 / ISC / MIT / ISC / MIT-0 / MIT | github.com/josdejong/mathjs github.com/josdejong/jsonrepair | math-eval, json-repair, json-validator, semver, email-parse, lang-detect | With the library version we ship |
| hono | MIT | github.com/honojs/hono | the whole API (router) | With the library version we ship |
Legal and reference calculations
Results of the tax, fee, insurance (social and health insurance), court-fee, inheritance, legal-deadline, visa, labelling, building-rule, water-tariff, exam-score and similar tools are reference calculations based on the legal texts they cite. They are not legal, tax, accounting, medical or immigration advice and do not replace the opinion of the authorities, a lawyer, an accountant or a health facility.
- Every response lists its legal basis (document number, articles, effective date) and the date the table was last reviewed (
reviewed). Hand-entered tables are re-checked on a fixed schedule (31 to 180 days depending on the table) and when new texts are published. - Legal texts can be amended, interpreted by guidance or applied differently by local authorities. Check the official text (Official Gazette, Government portal, ministry websites) before you file, pay or decide.
- Tables issued by provinces (water tariffs, local insurance top-ups…) may be incomplete; responses list their
coverageand flagunverifiedvalues when the original text could not be checked.
Found an error or a new legal text? E-mail support@apibox.io.vn with the endpoint, the parameters you sent (or the X-Request-Id header), the result you expected and the text it is based on. We check it, update the table and record the new review date.
See also the Terms of Service and the Privacy Policy.