masothue.com APImasothue.com ↗
Search and retrieve Vietnamese company tax registration data via the masothue.com API. Get tax codes, addresses, representatives, and business status.
curl -X GET 'https://api.parse.bot/scraper/7c178373-f050-44cc-a501-77854e1f2f14/search_company?type=enterpriseTax&query=0300588569' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for Vietnamese companies by name, tax code, ID number, or representative name. Returns paginated results with up to 20 companies per page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| type | string | Search type. Accepted values: auto, enterpriseTax, personalTax, identity, enterpriseName, legalName. |
| queryrequired | string | Search query - company name, tax code, ID number, or representative name. |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"type": "string - the search type used",
"query": "string - the search query submitted",
"companies": "array of company objects with name, tax_code, representative, address, detail_path",
"total_pages": "integer - total number of pages available",
"result_count": "integer - number of companies returned on this page"
},
"sample": {
"data": {
"page": 1,
"type": "auto",
"query": "Vinamilk",
"companies": [
{
"name": "CÔNG TY TNHH VINAMILK TÂN SƠN",
"address": "Số 357 Vườn Lài, Phường Phú Thọ Hoà, Quận Tân Phú, Thành phố Hồ Chí Minh, Việt Nam",
"tax_code": "0314539064",
"detail_path": "/0314539064-cong-ty-tnhh-vinamilk-tan-son",
"representative": "KIỀU LỆ QUYÊN"
}
],
"total_pages": 5,
"result_count": 20
},
"status": "success"
}
}About the masothue.com API
The masothue.com API provides 2 endpoints for querying Vietnam's company tax registration database. Use search_company to find businesses by name, tax code, national ID, or representative name, and get_company_detail to retrieve 10 structured fields per company including operating status, active date, managing tax office, primary industry, and legal entity type.
Search Vietnamese Companies
The search_company endpoint accepts a required query string and an optional type parameter to narrow how the query is interpreted. Accepted type values include auto, enterpriseTax, personalTax, identity, enterpriseName, and legalName. Results are paginated at up to 20 companies per page, with total_pages and result_count returned alongside each page. Each item in the companies array includes the company's name, tax code, representative, address, and a detail_path string used to fetch the full profile.
Company Detail Lookup
The get_company_detail endpoint accepts either a tax_code or a detail_path from prior search results. The detail_path approach is the most reliable way to resolve a specific entity — for example, passing /0314539064-cong-ty-tnhh-vinamilk-tan-son navigates directly to that company's record. The response covers company_name, short_name, company_type, status, active_date, address, tax_address, managed_by, and main_industry.
Data Coverage and Scope
All data reflects registered Vietnamese enterprises as recorded in the public tax registration system. Fields are returned in Vietnamese where the source record uses Vietnamese text. The tax_code field preserves leading zeros, which is important for correct identification of entities with codes beginning in 0. The active_date field follows YYYY-MM-DD format.
- Verify a Vietnamese supplier's tax registration status and active date before onboarding
- Resolve a company's official registered address and tax address from its tax code
- Identify the legal representative associated with a specific enterprise tax number
- Classify Vietnamese counterparties by company_type and main_industry for CRM enrichment
- Cross-reference an identity number against registered businesses to detect sole proprietors
- Build a due-diligence workflow that flags companies with non-active status
- Look up which tax office manages a given company via the managed_by field
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.