Tax code lookup

Retrieve detailed business information by tax code (MST).

GET /tax-code?tax={mst}

Billing

Each call = 1 billable request (tiered). See Per-request pricing.

Query Parameters

Name	Type	Required	Description
tax	string	✅	Tax code to look up

Response

Field	Type	Description
ma_so_thue	string	Tax code of the business
masothue_id	string	Tax code ID
ten_cty	string	Full company/business name
dia_chi	string	Registered business address
cqthuecap_tinh	string | null	Managing provincial tax office
cqthue_ql	string	Direct managing tax office
nguoi_dai_dien	string	Legal representative
ngay_thanh_lap	date (YYYY-MM-DD)	Establishment date
tthai	string | null	Operating status code
ten_tthai	string | null	Operating status name

cURL

curl "$BASE/tax-code?tax=0319074775" \
  -H "Authorization: Bearer $TOKEN" -H "Partner-Code: $PC"

Example response

{
  "success": true,
  "ma_so_thue": "0319074775",
  "masothue_id": "0319074775",
  "ten_cty": "CÔNG TY CỔ PHẦN GIẢI PHÁP T CONNECT",
  "dia_chi": "232 Nguyễn Lương Bằng, Phường Tân Mỹ, Thành phố Hồ Chí Minh, Việt Nam",
  "cqthuecap_tinh": "Chi cục thuế Hồ Chí Minh",
  "cqthue_ql": "Thuế cơ sở 7 Thành phố Hồ Chí Minh",
  "nguoi_dai_dien": null,
  "ngay_thanh_lap": null,
  "tthai": null,
  "ten_tthai": null
}

No encryption required

The API only accepts tax via query parameter; no AES needed. You still need the Bearer + Partner-Code authentication headers.