Vessel Filter API
Find Vessels by Type & Country
Filter our 830,000+ vessel database by specific vessel type, flag country, or both at once. Get paginated results with IMO, MMSI, call sign, and flag data — ready to chain into any other Data Docked endpoint.
1 Credit
Per request (only when results found)
Paginated
100 vessels per page
50/min
Rate limit
Filter any segment of the global fleet in one call
Pass a vessel type, a flag country, or both in the query string and get back a paginated list of matching vessels with all the identifiers you need. Use the IMO or MMSI to chain into any other Data Docked endpoint.
- 361 vessel types supported — From bulk carriers to floating cranes
- 273 flag countries supported — Every recognised maritime flag state
- Full identifier set — IMO, MMSI, call sign, flag, and type
- Chain into other endpoints — Use IMO/MMSI with location, particulars, and more
Filter Result
EVER GALLANT
IMO9624328
MMSI373843000
CountryPanama (PA)
typeSpecificBulk Carrier
callsign3EUN3
1 credit • 50 requests/min • 100 per page
Quick Start
At least one of type_specific or country is required
GET/api/vessels_operations/vessels-by-types-and-countries?type_specific=Bulk%20Carrier&country=Panama&page=1
Response200 OK
{
"total": 2417,
"items": [
{
"name": "EVER_GALLANT",
"mmsi": "373843000",
"imo": "9624328",
"callsign": "3EUN3",
"country": "Panama",
"countryIso": "PA",
"shipType": "Cargo vessels",
"typeSpecific": "Bulk Carrier"
}
],
"limit": 100,
"page": 1
}Cost: 1 credit • Rate limit: 50/min • Page size: 100
Who Uses This API?
Fleet Operators
Filter the global fleet by vessel type and flag to identify relevant vessels for charter, acquisition, or competitive analysis.
Commodity Traders
Find bulk carriers or tankers flagged to specific countries to assess available tonnage and market supply for a given commodity route.
Compliance Officers
Retrieve all vessels of a specific type flagged to a jurisdiction under review, then cross-reference against sanctions or inspection records.
Port Authorities
Identify inbound vessel types and flag states to plan berth allocation, customs resources, and port capacity in advance.
Frequently Asked Questions
Is at least one filter required?
Yes. You must provide type_specific, country, or both. Sending a request with neither parameter returns a 422 error — no credits are charged.
What values are valid for type_specific?
There are 361 accepted values and the match is case-insensitive. The value must be an exact string match (e.g. "Bulk Carrier", "Container Ship"). The dropdown in our API playground lists all valid values.
What values are valid for country?
There are 273 accepted country values. As with type_specific, the value must be an exact match (e.g. "Panama", "Liberia", "Marshall Islands"). The dropdown in our API playground lists all valid values.
How much does this endpoint cost?
1 credit per request, charged only when total > 0. Requests that return zero results or a 422 validation error are not charged.
What does IMO "0" mean in the response?
A vessel with IMO "0" has no registered IMO number — do not treat it as a valid IMO identifier. Use the MMSI for downstream lookups on these vessels.
Related Endpoints
Chain vessel filter results with these endpoints