Tax code lookup API
Look up business information by tax code (MST): company name, address, managing tax office, legal representative, date of establishment, operating status.
All paths below are relative to the base URL.
| No. | Function | Method | Endpoint | Billing |
|---|---|---|---|---|
| 1 | Tax code lookup | GET | /tax-code?tax={mst} | ✅ per request |
Characteristics
- No encryption required — only pass
taxvia a query parameter (unlike APIs that require AES). - Metered for billing — each call is counted as a request (sharing a common counter with the Purchase invoice lookup API); converted to money using tiered pricing. See Per-request pricing.
Authentication
Uses the shared Open API mechanism: Authorization: Bearer <access_token> + Partner-Code (see Introduction). This API does not encrypt the body/parameters.
Pricing (summary)
| Tier (up to request no.) | Unit price / request |
|---|---|
| 100 | 8.000đ |
| 500 | 4.000đ |
| 1.000 | 2.000đ |
| > 1.000 (excess) | 1.000đ |
Tiered pricing is regressive/volume-based — the more requests, the lower the unit price. Calculator tool: Per-request pricing.