Discover/masothue.com API
live

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.

Government Publicb2b directoryfinance
Endpoints
2
Updated
14d ago
Try it
Page number for pagination.
Search type. Accepted values: auto, enterpriseTax, personalTax, identity, enterpriseName, …
Search query - company name, tax code, ID number, or representative name.
→ api.parse.bot/scraper/7c178373-f050-44cc-a501-77854e1f2f14/<endpoint>
Ready to send
Fill in the parameters and hit sign in to send to see live response data here.
Use it in your codegrab a free API key at signup
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'
All endpoints · 2 totalclick to expand

Search for Vietnamese companies by name, tax code, ID number, or representative name. Returns paginated results with up to 20 companies per page.

Input
ParamTypeDescription
pageintegerPage number for pagination.
typestringSearch type. Accepted values: auto, enterpriseTax, personalTax, identity, enterpriseName, legalName.
queryrequiredstringSearch query - company name, tax code, ID number, or representative name.
Response
{
  "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.

Common use cases
  • 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
Pricing & limitsSee full pricing →
TierPriceCredits/monthRate limit
Free$0/mo1005 req/min
Hobby$30/mo1,00020 req/min
Developer$100/mo5,000250 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.

Frequently asked questions
Does masothue.com have an official developer API?+
No. masothue.com does not publish an official developer API or documented public endpoint for programmatic access to its tax registration data.
What does the search_company endpoint return, and how do I search by representative name?+
Each result in the companies array includes the company name, tax code, representative, address, and a detail_path. To search by representative name, set the type parameter to legalName and pass the person's name as the query string. Pagination is controlled via the page parameter, with result_count and total_pages indicating how many records were found.
Does the API return historical or dissolved company records?+
The status field in get_company_detail reflects the current registration state, which can indicate an inactive or dissolved entity. However, the API does not expose historical snapshots, previous addresses, or ownership change history. You can fork this API on Parse and revise it to add an endpoint targeting historical registration data if that becomes available on the source.
Is contact information like phone numbers or email addresses returned?+
Not currently. The API returns address, tax_address, representative, and managed_by, but does not include phone numbers or email addresses for registered companies. You can fork this API on Parse and revise it to add those fields if the source exposes them.
Why should I use detail_path instead of tax_code when calling get_company_detail?+
A single tax code can sometimes resolve ambiguously if the query path is constructed from the code alone. The detail_path returned by search_company includes both the tax code and a URL-safe version of the company name, which uniquely identifies the exact record and avoids resolving to an unintended entity.
Page content last updated . Spec covers 2 endpoints from masothue.com.
Related APIs in Government PublicSee all →
athletic.net API
Search and analyze cross country and track & field performance data across the US, including athlete profiles, meet results, team rosters, and rankings. Access comprehensive meet information, historical records, and state-level competition data to track athlete progress and discover top performers.
alienvault.com API
Search and analyze global threat intelligence data including indicators of compromise, threat pulses, and adversary profiles from the Open Threat Exchange community. Monitor recent security alerts and access detailed information about threats and adversaries to strengthen your cybersecurity defenses.
eprocurement.gov API
Monitor India's public procurement opportunities by accessing active tenders, bids closing today, global tenders, high-value contracts, and cancelled tenders from the Central Public Procurement Portal. Search tender details, browse participating organizations, and track real-time procurement statistics to stay informed on government contracting opportunities.
maradminbot.com API
Search and retrieve official Marine Corps MARADMIN announcements from Marines.mil, filtering by year, status, and keyword to stay updated on the latest personnel and administrative directives. Get detailed information about specific announcements by number or browse the most recent updates to ensure you never miss critical Marine Corps guidance.
13f.info API
13f.info API
illinoisreportcard.com API
Search and analyze comprehensive performance data for Illinois public schools, districts, and the state, including academic achievements in ELA, math, and science, student demographics, teacher and administrator information, school finances, and environmental conditions. Compare schools side-by-side, track growth metrics, and access accountability ratings and school highlights to make informed decisions about education quality.
customs.gov.mv API
Check import/export duties, tariff classifications, and exchange rates for Maldives customs compliance, plus track vessel movements, company registrations, and declaration statuses. Get real-time data directly from the official customs portal to streamline your trade and logistics operations.
bizapedia.com API
Search for detailed business profiles and contact information from Bizapedia, including company details, employee data, and communication channels. Access comprehensive business intelligence to research companies and build targeted contact lists.