Skip to main content
VN FR / API · Vietnam

Build on Vietnam filings programmatically.

A typed REST API over 107,686 filings from 516 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
107,686
in Vietnam
Listed companies
516
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

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 9,642
  • 2025 18,777
  • 2024 17,711
  • 2023 16,475
  • 2022 17,812
  • 2021 17,492

Reporting languages

Filing-by-filing distribution
  • Vietnamese 106,135
  • Tagalog 1,449
  • English 55
  • Chinese 20
  • Lithuanian 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.