Gov APIcustoms.gov.mv ↗
Access Maldives Customs tariff search, exchange rates, vessel movements, declaration status, and company data via the customs.gov.mv API.
What is the Gov 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.
curl -X GET 'https://api.parse.bot/scraper/e880965a-b5c5-4f95-bb7c-37611d1df306/search_tariff?query=rice' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace customs-gov-mv-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.maldives_customs_service_api import MaldivesCustoms, TariffItem, TariffDetail, ExchangeRate, VesselMovement, Company, Statistics
customs = MaldivesCustoms()
# Search tariff database for rice products
for item in customs.tariffitems.search(query="rice"):
print(item.hs_code, item.description, item.rate_percent, item.product_id)
# Get detailed tariff info for this item
detail = item.details()
print(detail.hs_code, detail.hs_description, detail.rate, detail.safta_rate)
# Explore related products under the same HS code
group = item.related_products.get()
print(group.hs_code_info.rate, group.hs_code_info.unit)
for commodity in group.products:
print(commodity.commodity_name, commodity.additional_info)
# List current exchange rates
for rate in customs.exchangerates.list():
print(rate.code, rate.flag, rate.rate)
# List recent vessel movements
for vessel in customs.vesselmovements.list():
print(vessel.vessel_name, vessel.operator, vessel.imo_reg_no, vessel.last_port)
# Search registered companies
for company in customs.companies.search(query="shipping"):
print(company.code, company.name, company.sector, company.company_reg_no)
# Check a declaration status
status = customs.declarationstatuses.check(form_no="R/1234/00MP", consig_no="C1234")
print(status.message, status.statuses)
# Get import/export statistics
stats = customs.statisticses.get()
for report in stats.import_reports:
print(report.title, report.url)
for report in stats.export_reports:
print(report.title, report.url)
Search the Maldives Customs tariff database by keyword or HS code. Returns matching items with standard duty rates, SAFTA preferential rates, and CMFTA preferential rates. Each result carries a product_id for detail lookup and an hscode_for_more for related-product exploration.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword or HS code prefix (e.g. 'rice', '1006') |
{
"type": "object",
"fields": {
"items": "array of tariff items 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": {
"items": [
{
"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 Gov API
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.
The Gov API is a managed, monitored endpoint for customs.gov.mv — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when customs.gov.mv changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official customs.gov.mv API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.