Skip to main content
VN FR / API · Vietnam

Build on Vietnam filings programmatically.

A typed REST API over 147,684 filings from 402 Vietnamese listed companies — JSON metadata, Markdown body, and original PDF. Webhooks on every new release.

Public-company filings in Vietnam are supervised by State Securities Commission of Vietnam (SSC). Reporting follows VAS (Vietnamese Accounting Standards). Filings are most commonly published in Vietnamese. Major issuers are listed on VN-Index, HNX-Index and VN30. Calendar year.

Building on Vietnamese filings programmatically

The FinancialReports API delivers Vietnamese regulatory filings — from HOSE, HNX, and UPCoM — through the standard unified endpoint. A ?country=VN filter scopes queries to Vietnamese issuers. Volume is moderate: ~1,600 companies under quarterly and semi-annual reporting mandates generate approximately 2,000–4,000 filings per month during peak periods.

Webhook subscriptions deliver Vietnamese filings within minutes of exchange publication. Vietnamese market disclosure follows HOSE/HNX trading hours (09:00–15:00 ICT, UTC+7). The webhook payload schema is market-agnostic. Vietnam's SSC deadline structure mandates quarterly reports within 20 days of quarter-end (30 days for consolidated), creating predictable filing concentration windows.

Filing content is available as JSON metadata, Markdown (extracted from Vietnamese-language PDFs), and original source documents. The Vietnamese-language character of filings means NLP integrations require Vietnamese processing capability or translation. Common API integrations include VN30 fundamental data feeds, Vietnamese banking sector monitoring, FDI-sector tracking (export manufacturing companies supplying Samsung, Apple, Intel), frontier-to-emerging market reclassification research (FTSE Russell and MSCI monitoring Vietnamese market accessibility), and cross-ASEAN sector analysis combining HOSE/HNX data with IDX, SGX, and Bursa Malaysia feeds.

Filings indexed
147,684
in Vietnam
Listed companies
402
Vietnamese issuers
Auth
x-api-key
single header
Webhook latency
< 1 min
from regulator publish

Reporting at a glance — Vietnam

Regulator, indices, accounting, language
Primary indices
VN-IndexHNX-IndexVN30
Accounting standards
VAS (Vietnamese Accounting Standards)
Reporting languages
Vietnamese
Fiscal year
Calendar year

Quick start — Vietnam filings

REST · JSON · Markdown · PDF
# 1. List filings for Vietnam, newest first
curl "https://api.financialreports.eu/api/filings/?countries=VN" \
    -H "x-api-key: $FR_API_KEY"

# 2. Pull full Markdown for one filing
curl https://api.financialreports.eu/api/filings/<id>/markdown/ \
    -H "x-api-key: $FR_API_KEY"

# 3. Filter by filing type — annual reports only
curl "https://api.financialreports.eu/api/filings/?countries=VN&type=10-K" \
    -H "x-api-key: $FR_API_KEY"

# 4. Filter by ISIN (single issuer)
curl "https://api.financialreports.eu/api/filings/?company_isin=DE000A1EWWW0" \
    -H "x-api-key: $FR_API_KEY"

Full API documentation ↗ · OpenAPI schema ↗

Sample Vietnam response

Real filings · live data
Filing Type Released
TNH: Thông báo thay đổi nhân sự Công ty Cổ phần Tập đoàn Bệnh viện TNH · TNH Board/Management Information 2026-05-18
CTR: Thông báo thay đổi nội dung đăng ký doanh nghiệp Tổng Công ty Cổ phần Công trình Viettel · CTR Regulatory Filings 2026-05-18
NO1: Điều lệ công ty Công ty Cổ phần Tập đoàn 911 · NO1 Governance Information 2026-05-18
NO1: Nghị quyết và Biên bản họp ĐHĐCĐ thường niên 2026 Công ty Cổ phần Tập đoàn 911 · NO1 AGM Information 2026-05-18
AGR: Nghị quyết HĐQT về việc lựa chọn công ty kiểm toán BCTC năm 2026 Công ty Cổ phần Chứng khoán Agribank · AGR Regulatory Filings 2026-05-18
CKG: Thông báo về việc Công ty Cổ phần Địa ốc CIC Real chính thức giải thể Công ty Cổ phần Tập đoàn CIC · CKG Regulatory Filings 2026-05-18
VSC: Nghị quyết HĐQT thông qua việc sửa đổi tài liệu họp ĐHĐCĐ thường niên năm 2026 Công ty Cổ phần Container Việt Nam · VSC Proxy Solicitation & Information Statement 2026-05-18
VNE: Báo cáo thường niên năm 2025 Tổng Công ty Cổ phần Xây dựng Điện Việt Nam · VNE Annual Report 2026-05-18
HHP: Thông báo thay đổi nhân sự - Miễn nhiệm và bổ nhiệm thành viên HĐQT Công ty Cổ phần HHP Global · HHP Board/Management Information 2026-05-18
MBB: Thông qua hợp đồng giao dịch về cung cấp dịch vụ tư vấn phát hành cổ phiếu giữa MB và MBS Ngân hàng Thương mại Cổ phần Quân Đội · MBB Regulatory Filings 2026-05-18

Get API access for Vietnam

Pricing · trial keys · enterprise
Get API access Talk to the team Read the docs ↗

Filings activity by year

Last 6 years · Vietnamese issuers
  • 2026 8,352
  • 2025 18,849
  • 2024 17,865
  • 2023 16,543
  • 2022 17,917
  • 2021 17,635

Reporting languages

Filing-by-filing distribution
  • Vietnamese 147,287
  • Tagalog 386
  • English 9
  • Chinese 1
  • German 1

FAQ — Vietnam

Coverage, formats, integration
How do I authenticate API requests for Vietnam filings?
Send a single header — `x-api-key: $FR_API_KEY` — on every request. The same key works across all 42 covered markets; there's no per-country key.
What format does the Vietnam API return?
Filing metadata is returned as JSON. Full filing bodies are available as Markdown (one endpoint) and original PDF. The same payload shape is used across every covered market.
Do you provide webhooks for new Vietnamese filings?
Yes. Webhook subscribers receive a POST with full filing metadata within ~60 seconds of the regulator publishing the document.
Is there a rate limit on the Vietnamese API?
Standard plans are throttled to a generous request budget that suits typical research and dashboards. Bulk and high-throughput plans negotiate higher limits.
Is there a free tier for Vietnam data?
The web product (search, browse, single-filing read) is free and indexed for the public web. Programmatic API access is a paid plan; trial keys are available on request.