# VesselFinder API: Get vessel location > Finds a ship on VesselFinder by name, IMO or MMSI and returns its public position, voyage and vessel details. Unofficial. Not affiliated with or endorsed by VesselFinder. - Page: https://fous.com/methods/vesselfinder.com/get-vessel-location - Method: `vesselfinder.com/get_vessel_location`, version 1 - Website: vesselfinder.com - Returns: name, type, flag, IMO, MMSI, position, speed, course, destination, last port, dimensions, photo and link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `ship_name` | string | yes | `"Queen Mary 2"` | Ship name, IMO or MMSI, for example Ever Given or 9811000. | | `ship_type` | string | no | `"passenger"` | Type to match when ships share a name, for example passenger. One of "any", "container", "tanker", "cargo", "passenger", "other". Default "any". | | `flag_country` | string | no | `"Bermuda"` | Flag country to match, for example Bermuda. | ## Output From a run on Oct 23, 2026. Its input: ```json { "ship_name": "Queen Mary 2", "ship_type": "passenger", "flag_country": "Bermuda" } ``` Its output: ```json { "imo": "9241061", "mmsi": "310627000", "latitude": 51, "last_port": "Zeebrugge, Belgium", "longitude": -1, "ship_name": "QUEEN MARY 2", "ship_type": "Passenger (Cruise) Ship", "photo_link": "https://static.vesselfinder.net/ship-photo/9241061-310627000-e141b9bad530ffccbe517e972c8658dc/1?v1", "year_built": 2003, "speed_knots": 0, "flag_country": "Bermuda", "width_meters": 48.7, "gross_tonnage": 149215, "length_meters": 345.03, "other_matches": [], "course_degrees": 294.8, "departure_time": "Oct 22, 15:53 UTC", "estimated_arrival": null, "navigation_status": "Moored", "position_received": "2 min ago", "vesselfinder_link": "https://www.vesselfinder.com/vessels/details/9241061", "reported_destination": "Southampton, United Kingdom (UK)" } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"vesselfinder.com/get_vessel_location","input":{"ship_name":"Queen Mary 2","ship_type":"passenger","flag_country":"Bermuda"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Where is the container ship Ever Given right now, and what is its current speed and heading? - Find the tanker with MMSI 219018000 and tell me its last port and next destination. - Look up IMO 9811000 and give me its flag, dimensions and a photo if one is available. - I need the live position of a passenger ship called Queen Anne flagged in Bermuda on vesselfinder.com. - Which cargo vessel named Atlantic Star is sailing under the Panama flag, and where was it last docked? ## Input schema ```json { "type": "object", "required": [ "ship_name" ], "properties": { "ship_name": { "type": "string", "description": "Ship name, IMO or MMSI, for example Ever Given or 9811000." }, "ship_type": { "enum": [ "any", "container", "tanker", "cargo", "passenger", "other" ], "type": "string", "default": "any", "description": "Type to match when ships share a name, for example passenger." }, "flag_country": { "type": "string", "description": "Flag country to match, for example Bermuda." } } } ``` ## Output schema ```json { "type": "object", "required": [ "ship_name", "ship_type", "flag_country", "imo", "mmsi", "latitude", "longitude", "position_received", "navigation_status", "speed_knots", "course_degrees", "reported_destination", "estimated_arrival", "last_port", "departure_time", "length_meters", "width_meters", "gross_tonnage", "year_built", "photo_link", "vesselfinder_link", "other_matches" ], "properties": { "imo": { "type": [ "string", "null" ] }, "mmsi": { "type": [ "string", "null" ] }, "latitude": { "type": [ "number", "null" ] }, "last_port": { "type": [ "string", "null" ] }, "longitude": { "type": [ "number", "null" ] }, "ship_name": { "type": [ "string", "null" ] }, "ship_type": { "type": [ "string", "null" ] }, "photo_link": { "type": [ "string", "null" ] }, "year_built": { "type": [ "integer", "null" ] }, "speed_knots": { "type": [ "number", "null" ] }, "flag_country": { "type": [ "string", "null" ] }, "width_meters": { "type": [ "number", "null" ] }, "gross_tonnage": { "type": [ "number", "null" ] }, "length_meters": { "type": [ "number", "null" ] }, "other_matches": { "type": "array", "items": { "type": "object", "required": [ "ship_name", "ship_type", "flag_country" ], "properties": { "ship_name": { "type": "string" }, "ship_type": { "type": [ "string", "null" ] }, "flag_country": { "type": [ "string", "null" ] } } } }, "course_degrees": { "type": [ "number", "null" ] }, "departure_time": { "type": [ "string", "null" ] }, "estimated_arrival": { "type": [ "string", "null" ] }, "navigation_status": { "type": [ "string", "null" ] }, "position_received": { "type": [ "string", "null" ] }, "vesselfinder_link": { "type": [ "string", "null" ] }, "reported_destination": { "type": [ "string", "null" ] } } } ``` ## See more - [Maersk API: Track a container or shipment](https://fous.com/methods/maersk.com/track-container.md): Tracks a Maersk ocean container or shipment by container, bill of lading or booking number. Returns container milestones, vessel details and estimated arrival, with times in the local time of each location when its time zone can be identified. - [Vivino API: Search wines](https://fous.com/methods/vivino.com/search-wines.md): Finds Vivino wines matching a wine name (optionally with the winery and a vintage year), in Vivino relevance order, with ratings, vintage, origin, bottle photo and the US price when shown. - [Vinted API: Search listings](https://fous.com/methods/vinted.com/search-listings.md): Searches public Vinted listings in one country with brand, size, condition, price and sorting filters. Returns up to 96 available items with seller usernames when the public profile is available. - [Freightos API: Get container freight rates](https://fous.com/methods/freightos.com/get-container-freight-rates.md): Returns the latest public weekly Freightos Baltic Index (FBX) price per 40-foot container for one trade lane, or for the global composite and all twelve lanes. - [Docker API: Get container image details](https://fous.com/methods/hub.docker.com/get-container-image.md): Gets public Docker Hub image details and the newest tags from an image name or Docker Hub page link. Signature and metadata artifact tags are omitted; size is the reported compressed tag size. - [Finviz API: Get stock snapshot](https://fous.com/methods/finviz.com/get-stock-snapshot.md): Get a delayed US-listed stock snapshot from its ticker or company name. Analyst labels summarize Finviz's 1-5 mean score; dividend yield uses the estimated dividend when available. Missing metrics return null. - [OpenStreetMap API: Search places](https://fous.com/methods/openstreetmap.org/search-places.md): Finds named places or kinds of places in a city or area, in search order, using OpenStreetMap Nominatim. Results may be fewer than requested. Data © OpenStreetMap contributors (ODbL). - [Docker API: Search container images](https://fous.com/methods/hub.docker.com/search-container-images.md): Finds public Docker Hub container images matching a software name, in Docker Hub search order, with publisher, badge, stars, last update and exact total pulls when Docker Hub publishes them. Can keep only Docker Official Images and Verified Publisher images.