Multi-country Support
What it does
POTAL supports 240 countries and territories with localized tax rules, duty rates, and regulatory requirements. The /countries endpoint provides a full list of supported countries with their VAT rates, de minimis thresholds, currency codes, and FTA status. Data is grouped by region and available in 50 languages.
Required Fields for 100% Accuracy
0 required / 2 total| Field | Type | Required |
|---|---|---|
region | string | opt |
lang | string | opt |
Tips for Best Accuracy
- ✓No authentication required — this is a public endpoint
- ✓Response is cached for 24 hours — data refreshes daily
- ✓Use country codes from this endpoint in all other API calls
Common Mistakes
- ✗Using country names from this endpoint directly — always use the code field (2-letter ISO) in other API calls
How to use it
List all countries
GET /api/v1/countries returns the full list with tax rates and thresholds.
Filter by region
Add ?region=Europe to filter by geographic region.
Get localized names
Add ?lang=ja to get country names in Japanese (or any of 50 languages).
Use in calculations
Pass country codes from this list to /calculate or /classify endpoints.
API Reference
/api/v1/countries// No request body needed for GET
// Optional query: ?region=Asia&lang=en{
"success": true,
"data": {
"countries": [
{
"code": "JP",
"name": "Japan",
"region": "Asia",
"vatRate": 10,
"deMinimisUsd": 130,
"currency": "JPY"
},
{
"code": "KR",
"name": "South Korea",
"region": "Asia",
"vatRate": 10,
"deMinimisUsd": 150,
"currency": "KRW"
}
],
"total": 240
}
}curl https://potal.app/api/v1/countries?region=Asia&lang=en \
-H "X-API-Key: pk_live_your_key"Related Features
Get the full import cost including duties, taxes, fees, and shipping
Automatically check if shipment value falls below duty-free threshold
Identify applicable Free Trade Agreements across 63 FTAs
Enforce country-specific import bans and product restrictions
Calculate VAT, GST, and sales tax for 240 countries and territories