customs.gov.mv APIcustoms.gov.mv ↗
Access Maldives Customs tariff search, exchange rates, vessel movements, declaration status, and company data via the customs.gov.mv API.
curl -X GET 'https://api.parse.bot/scraper/e880965a-b5c5-4f95-bb7c-37611d1df306/search_tariff?query=rice' \ -H 'X-API-Key: $PARSE_API_KEY'
Search the Maldives Customs tariff database by keyword or HS code. Returns a list of matching items with duty rates, SAFTA rates, and CMFTA rates.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g. 'rice', 'apples') or HS code prefix (e.g. '1006') |
{
"type": "object",
"fields": {
"data": "array of tariff items, each with hs_code, description, hs_unit, rate_percent, specific_rate, safta_rate_percent, safta_specific_rate, cmfta_rate_percent, cmfta_specific_rate, product_id, hscode_for_more"
},
"sample": {
"data": [
{
"hs_code": "1006200010",
"hs_unit": "KGM",
"product_id": "13327",
"description": "RICE IN PERICARP",
"rate_percent": "0",
"specific_rate": "0.00",
"hscode_for_more": "1006200010",
"cmfta_rate_percent": "0",
"safta_rate_percent": "0",
"cmfta_specific_rate": "0.00",
"safta_specific_rate": "0.00"
}
],
"status": "success"
}
}About the customs.gov.mv API
The Maldives Customs Service API exposes 8 endpoints covering tariff lookups, exchange rates, vessel movements, company registrations, declaration tracking, and statistics reports from customs.gov.mv. The search_tariff endpoint returns HS codes, duty rates, SAFTA rates, and CMFTA rates by keyword or HS code prefix, giving trade compliance tools direct access to the official Maldivian tariff schedule.
Tariff Data
The search_tariff endpoint accepts a keyword (e.g. rice) or HS code prefix (e.g. 1006) and returns an array of matching tariff items including hs_code, description, hs_unit, rate_percent, specific_rate, safta_rate_percent, and cmfta_rate. Once you have a product_id from those results, get_tariff_details returns the full record for that product including SAFTA and CMFTA specific rates. To enumerate all commodities sharing a given HS code, pass the hscode_for_more value to get_tariff_products_by_hs_code, which returns both rate metadata and a product list with commodity_name and additional_info fields.
Trade Operations
get_exchange_rates returns the customs-accepted MVR conversion rates for all supported currencies, with each record containing a flag country code, currency code, and numeric rate. get_vessel_movements provides recent vessel arrival and departure records at Maldivian ports, including vessel_name, operator, imo_reg_no, last_port, arrival_port, eta_date, and arrived_date. check_declaration_status accepts a form_no (format X/NNNN/NNXX) and consig_no and returns a message plus a statuses array of history entries for that declaration — or an empty array if no match is found.
Company Registry and Statistics
search_company queries companies registered with Maldives Customs by name or keyword, returning records with code, name, address, sector, company_reg_no, and tin. get_statistics retrieves metadata for published import and export statistics reports, returning two arrays — import and export — each containing report title and download url fields. No query parameters are required for either exchange rates, vessel movements, or statistics.
- Calculate landed cost for goods entering the Maldives by pulling duty rates and SAFTA/CMFTA concession rates from
search_tariff - Automate MVR currency conversion in trade finance tools using live rates from
get_exchange_rates - Monitor port logistics by tracking vessel ETAs and arrival dates from
get_vessel_movements - Verify declaration progress for a shipment using form number and consignment number in
check_declaration_status - Enrich importer/exporter records by resolving company TIN and registration details via
search_company - Build HS code classification tools that enumerate all products under a given code using
get_tariff_products_by_hs_code - Automate download of official Maldives import and export statistics reports from URLs returned by
get_statistics
| 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.
Does the Maldives Customs Service offer an official developer API?+
What does `check_declaration_status` return if the declaration number is not found?+
message field and a statuses array. If no declaration matches the provided form_no and consig_no, the statuses array will be empty. The form_no must follow the format X/NNNN/NNXX with exactly three slash-separated parts, otherwise the lookup will not match.Does the API return historical exchange rate data or only current rates?+
get_exchange_rates endpoint returns only the current customs-accepted rates — there is no date parameter and no historical series. You can fork this API on Parse and revise it to add a historical rates endpoint if that data becomes available on the source.Does the API cover import/export permit applications or cargo manifests beyond vessel movements?+
How granular is the tariff rate data — does it include preferential rates beyond SAFTA?+
search_tariff and get_tariff_details includes both SAFTA (South Asian Free Trade Area) and CMFTA (China-Maldives Free Trade Agreement) rates alongside the standard rate_percent and specific_rate fields. No additional preferential rate schemes beyond SAFTA and CMFTA are currently exposed.