Find vessels (registry search)
find_vesselsSearch the vessel registry by any combination of name (optionally fuzzy), type, flag country, dimensions, tonnage, or year built — no MMSI or IMO needed. Returns up to 500 static specification records per page (tonnage, dimensions, year built, home port, callsign, etc.) — this is reference data, NOT live position. Provide at least one search criterion; use the response's next token via the next argument to page. Credits: 1 per vessel found. For a vessel's live position use get_vessel; for vessels currently in an area use get_vessels_in_radius.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Vessel name to search for. Combine with fuzzy for similar-name matching. | |
| next | No | Pagination token from a previous response's next field, to fetch the next page (up to 500 results per page). | |
| type | No | Filter by vessel type (e.g. Cargo, Tanker). | |
| fuzzy | No | If true, match similar/approximate names; if false (default) the name must match exactly. Only meaningful together with name. | |
| length_max | No | Maximum length (meters). | |
| length_min | No | Minimum length (meters). | |
| breadth_max | No | Maximum breadth (meters). | |
| breadth_min | No | Minimum breadth (meters). | |
| country_iso | No | Filter by flag country, 2-letter ISO code (e.g. MT). | |
| type_specific | No | Filter by vessel subtype (e.g. Bulk Carrier). | |
| deadweight_max | No | Maximum deadweight (tonnes). | |
| deadweight_min | No | Minimum deadweight (tonnes). | |
| year_built_max | No | Latest year built. | |
| year_built_min | No | Earliest year built. | |
| gross_tonnage_max | No | Maximum gross tonnage. | |
| gross_tonnage_min | No | Minimum gross tonnage. | |
| include_unknown_type | No | Include vessels with no/unknown type. Maps to the API's _empty_. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| next | Yes | ||
| vessels | Yes |