Skip to main content
VN FR / API · Vietnam

Build on Vietnam filings programmatically.

A typed REST API over 118,133 filings from 1,082 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 - spanning HOSE, HNX, and UPCoM issuers - 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 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
118,133
in Vietnam
Listed companies
1,082
Vietnamese issuers
Auth
x-api-key
single header
Webhook latency
< 1 min
from regulator publish

Reporting at a glance - Vietnam

Regulator, indices, accounting, language
Regulator
State Securities Commission of Vietnam (SSC)
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
CLW: Thông báo về ngày đăng ký cuối cùng tham dự ĐHĐCĐ bất thường năm 2026 Công ty Cổ phần Cấp nước Chợ Lớn · CLW Regulatory Filings 2026-07-31
MCH: Thông báo về ngày đăng ký cuối cùng tạm ứng cổ tức bằng tiền đợt 1 năm 2026 Công ty Cổ phần Hàng tiêu dùng Masan · MCH Notice of Dividend Amount 2026-07-31
VPX: Thông báo về ngày đăng ký cuối cùng thực hiện lấy ý kiến cổ đông bằng văn bản lần 1 năm 2026 Công ty Cổ phần Chứng khoán VPBank · VPX Regulatory Filings 2026-07-31
PNC: Thông báo ngày ĐKCC thực hiện lấy ý kiến cổ đông bằng văn bản Công ty Cổ phần Văn hóa Phương Nam · PNC AGM Information 2026-07-31
TDW: Thông báo ngày ĐKCC tham dự ĐHĐCĐ bất thường năm 2026 Công ty Cổ phần Cấp nước Thủ Đức · TDW Regulatory Filings 2026-07-31
SHB: Thông báo về việc ký hợp đồng với đơn vị kiểm toán BCTC năm 2026 Ngân hàng Thương mại Cổ phần Sài Gòn – Hà Nội · SHB Regulatory Filings 2026-07-31
PLX: Giải trình BCTC quý 2/2026 so với cùng kỳ năm trước Tập đoàn Xăng dầu Việt Nam · PLX Management Reports 2026-07-31
OCB: Giải trình biến động LNST quý 2/2026 so với cùng kỳ năm trước Ngân hàng Thương mại Cổ phần Phương Đông · OCB Management Reports 2026-07-31
LGC: Giải trình chênh lệch BCTC HN quý 2/2026 và lũy kế 6 tháng đầu năm 2026 so với cùng kỳ năm trước Công ty Cổ phần Đầu tư Cầu Đường CII · LGC Management Reports 2026-07-31
SBT: Giải trình biến động KQKD Quý 4 niên độ 2025-2026 Công ty Cổ phần Thành Thành Công - Biên Hòa · SBT Management Reports 2026-07-31

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 13,512
  • 2025 19,986
  • 2024 18,826
  • 2023 17,299
  • 2022 18,973
  • 2021 19,059

Reporting languages

Filing-by-filing distribution
  • Vietnamese 115,998
  • Tagalog 1,648
  • English 450
  • Chinese 31
  • Dutch 3

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.