openapi: 3.2.0 info: title: ShipFinder Global Maritime Data 1 AIS Dataset/1.1 Vessel… description: Verbatim assembly of the per-endpoint OpenAPI 3.0.1 fragments ShipFinder publishes on docs.shipfinder.com (one fragment per endpoint page, indexed by the provider llms.txt). Path items are reproduced exactly as published; only the enclosing document (info/servers/tags) is API Evangelist assembly. No operation content was altered. version: 1.0.0 servers: [] tags: - name: 1 AIS Dataset/1.1 Vessel Position paths: /v1/AIS/FleetPosition: get: summary: 1.1.3 Fleet Position deprecated: false description: '' tags: - 1 AIS Dataset/1.1 Vessel Position parameters: - name: key in: query description: fleet ID personal Shipfinder API key to verify service permissions required: true example: 1F6D701272402D1E7D8D316CCE519123 schema: type: string - name: fleet_id in: query description: 'All vessel positions under the fleet can be retrieved by the fleet ID maintained in the Dashboard. ' required: true example: 98f1f00a-d2d4-431b-90bf-d5471b184ff6 schema: type: string responses: '0': description: '' content: application/json: schema: type: object properties: status: type: integer msg: type: string total: type: integer data: type: array items: type: object properties: fleet_id: type: string description: Your fleet ID mmsi: type: integer description: 9-digit numeric code of MMSI imo: type: integer description: 7-digit numeric code of IMO call_sign: type: string description: 'Call Sign ' ship_name: type: string description: Vessel name ship_cnname: type: string description: Chinese name of the vessel data_source: type: string description: 0=Terrestrial AIS stations or Shipborne AIS; 1=Satellite AIS lat: type: number description: Coordinate latitude, WGS84 coordinate system lng: type: number description: Coordinate longitude, WGS84 coordinate system ship_type: type: integer length: type: number description: 'Vessel length in meters, valid value range: 0–1022' width: type: number description: Vessel breadth in meters (nautical standard term) left: type: number description: Port distance in meters trail: type: number description: Stern Distance in meters draught: type: number description: Vessel draught depth in meters dest: type: string description: Standardized destination port names, e.g., SINGAPORE, SG destcode: type: string description: Port code of the destination, e.g., SGSGP navistat: type: integer description: 0, Vessel navigation status; -1=invalid data sog: type: number description: Real-time vessel speed over ground in knots; -1=invalid data cog: type: number description: Course over ground in degrees ; -1=invalid data hdg: type: integer description: Vessel heading in degrees; 511=invalid data rot: type: number description: Rate of turn in degrees per minute last_time: type: integer description: AIS last update time in Unix timestamp eta: type: integer description: Estimated Time of Arrival in Unix timestamp required: - fleet_id - mmsi - imo - call_sign - ship_name - ship_cnname - data_source - last_time - lat - lng - ship_type - length - width - left - trail - draught - dest - destcode - eta - navistat - sog - cog - hdg - rot x-apifox-orders: - fleet_id - mmsi - imo - call_sign - ship_name - ship_cnname - data_source - last_time - lat - lng - ship_type - length - width - left - trail - draught - dest - destcode - eta - navistat - sog - cog - hdg - rot required: - status - msg - total - data x-apifox-orders: - status - msg - total - data example: status: 0 msg: '' total: 3 data: - fleet_id: 98f1f00a-d2d4-431b-90bf-d5471b184ff6 mmsi: 241673000 imo: 9852119 call_sign: SVDF6 ship_name: SEA EMERALD ship_cnname: '' data_source: 1 last_time: 1774950228 lat: 25.622803 lng: 53.367208 ship_type: 80 length: 336 width: 60 left: 31 trail: 55 draught: 20.4 dest: CNZNG destcode: '' eta: 1776283200 navistat: 0 sog: 0.7003891 cog: 286.1 hdg: 126 rot: -0.01 - fleet_id: 98f1f00a-d2d4-431b-90bf-d5471b184ff6 mmsi: 477985700 imo: 9308479 call_sign: VRDJ3 ship_name: DAPENG SUN ship_cnname: '' data_source: 1 last_time: 1774950155 lat: 21.452173 lng: 114.80732 ship_type: 80 length: 291 width: 43 left: 22 trail: 55 draught: 9.6 dest: CN DPGAU DAM destcode: '' eta: 1775660400 navistat: 0 sog: 16.2140083 cog: 178.8 hdg: 179 rot: 0 headers: {} x-apifox-name: success security: [] x-apifox-folder: 1 AIS Dataset/1.1 Vessel Position x-apifox-status: released x-run-in-apifox: https://app.apifox.com/web/project/7948067/apis/api-430293359-run operationId: getV1AISFleetPosition x-operation-id-source: derived /v1/AIS/VesselPositionMulti: get: summary: 1.1.2 Multi-vessel Position deprecated: false description: ' ' tags: - 1 AIS Dataset/1.1 Vessel Position parameters: - name: key in: query description: Your personal Shipfinderer API key to verify service permissions required: true example: 1F6D701272402D1E7D8D316CCE519123 schema: type: string - name: mmsis in: query description: For Multi-Vessel Search, 9-digit MMSIs shall be separated by English commas, with a maximum of 100 vessels per search.
**Note:** The required parameter is MMSIs (plural form), not the singular MMSI. For multi-vessel search, requests will still be processed successfully even if invalid parameter content is submitted. However, only valid 9-digit MMSIs will be counted toward your usage credits, and invalid MMSIs will not be recorded as used credits. required: true example: 477232800,477172700 schema: type: string responses: '0': description: '' content: application/json: schema: type: object properties: status: type: integer msg: type: string data: type: array items: type: object properties: mmsi: type: integer description: 9-digit numeric code of MMSI imo: type: integer description: 7-digit numeric code of IMO call_sign: type: string description: 'Call Sign ' ship_name: type: string description: Vessel name ship_cnname: type: string description: Chinese name of the vessel data_source: type: integer description: 0=Terrestrial AIS stations or Shipborne AIS; 1=Satellite AIS ship_type: type: integer description: 'Numeric code of vessel type: see Appendix for details ' length: type: number description: 'Vessel length in meters, valid value range: 0–1022' width: type: number description: Vessel breadth in meters (nautical standard term) left: type: number description: Port distance in meters trail: type: number description: Stern Distance in meters draught: type: number description: Vessel draught depth in meters dest: type: string description: Standardized destination port names, e.g., SINGAPORE, SG destcode: type: string description: Port code of the destination, e.g., SGSGP navistat: type: integer description: 0, Vessel navigation status; -1=invalid data lat: type: number description: Coordinate latitude, WGS84 coordinate system lng: type: number description: Coordinate longitude, WGS84 coordinate system sog: type: number description: Real-time vessel speed over ground in knots; -1=invalid data cog: type: number description: Course over ground in degrees ; -1=invalid data hdg: type: number description: Vessel heading in degrees; 511=invalid data rot: type: number description: Rate of turn in degrees per minute last_time: type: integer description: AIS last update time in Unix timestamp eta: type: integer description: Estimated Time of Arrival in Unix timestamp required: - mmsi - imo - call_sign - ship_name - ship_cnname - data_source - ship_type - length - width - left - trail - draught - dest - destcode - eta - navistat - lat - lng - sog - cog - hdg - rot - last_time x-apifox-orders: - mmsi - imo - call_sign - ship_name - ship_cnname - data_source - ship_type - length - width - left - trail - draught - dest - destcode - eta - navistat - lat - lng - sog - cog - hdg - rot - last_time required: - status - msg - data x-apifox-orders: - status - msg - data example: status: 0 msg: '' data: - mmsi: 477232800 imo: 9789647 call_sign: VRSG2 ship_name: COSCO PISCES ship_cnname: '' data_source: 1 ship_type: 100 length: 400 width: 59 left: 24 trail: 241 draught: 12.5 dest: 'ESVLC > SGSIN-PWBGA ' destcode: '' eta: 1775145600 navistat: 0 lat: 4.095627 lng: 92.529245 sog: 12.7 cog: 48.5 hdg: 49 rot: 0 last_time: 1774945102 - mmsi: 477172700 imo: 9783538 call_sign: VRRV4 ship_name: COSCO SHIPPING LIBRA ship_cnname: '' data_source: 1 ship_type: 100 length: 399 width: 59 left: 33 trail: 256 draught: 13 dest: SHANGHAI,CN destcode: CNSHG eta: 1776691800 navistat: 0 lat: -21.220912 lng: 6.866182 sog: 17.9 cog: 142.9 hdg: 143 rot: 0 last_time: 1774945234 headers: {} x-apifox-name: success security: [] x-apifox-folder: 1 AIS Dataset/1.1 Vessel Position x-apifox-status: released x-run-in-apifox: https://app.apifox.com/web/project/7948067/apis/api-430292321-run operationId: getV1AISVesselPositionMulti x-operation-id-source: derived /v1/AIS/VesselPositionSingle: get: summary: 1.1.1 Single Vessel Position deprecated: false description: '' tags: - 1 AIS Dataset/1.1 Vessel Position parameters: - name: key in: query description: Your personal Shipfinder API key to verify service permissions required: true example: 1F6D701272402D1E7D8D316CCE519123 schema: type: string - name: mmsi in: query description: '9-digit numeric code of MMSI ' required: true example: '413149000' schema: type: string responses: '0': description: '' content: application/json: schema: type: object properties: status: type: integer description: API call status code,0 means success msg: type: string description: Exception prompt message data: type: object properties: mmsi: type: integer description: 9-digit numeric code of MMSI imo: type: integer description: 7-digit numeric code of IMO call_sign: type: string description: 'Call Sign ' ship_name: type: string description: Vessel name ship_cnname: type: string description: Chinese name of the vessel data_source: type: integer description: 0=Terrestrial AIS stations or Shipborne AIS; 1=Satellite AIS ship_type: type: integer description: 'Numeric code of vessel type: see Appendix for details ' length: type: number description: 'Vessel length in meters, valid value range: 0–1022' width: type: number description: Vessel breadth in meters (nautical standard term) left: type: number description: Port distance in meters trail: type: number description: Stern Distance in meters draught: type: number description: Vessel draught depth in meters dest: type: string description: Standardized destination port names, e.g., SINGAPORE, SG destcode: type: string description: Port code of the destination, e.g., SGSGP eta: type: string description: 'Estimated Time of Arrival. Format: YYYY-MM-DD HH:MM:SS, UTC' navistat: type: integer description: 0, Vessel navigation status; -1=invalid data lat: type: number description: Coordinate latitude, WGS84 coordinate system lng: type: number description: Coordinate longitude, WGS84 coordinate system sog: type: number description: Real-time vessel speed over ground in knots; -1=invalid data cog: type: number description: Course over ground in degrees ; -1=invalid data hdg: type: number description: Vessel heading in degrees; 511=invalid data rot: type: number description: Rate of turn in degrees per minute last_time: type: integer description: AIS last update time in Unix timestamp required: - mmsi - imo - call_sign - ship_name - ship_cnname - data_source - ship_type - length - width - left - trail - draught - dest - destcode - eta - navistat - lat - lng - sog - cog - hdg - rot - last_time x-apifox-orders: - mmsi - imo - call_sign - ship_name - ship_cnname - data_source - ship_type - length - width - left - trail - draught - dest - destcode - eta - navistat - lat - lng - sog - cog - hdg - rot - last_time required: - status - msg - data x-apifox-orders: - status - msg - data example: status: 0 msg: '' data: mmsi: 413961925 imo: 0 call_sign: P ship_name: WANHONGYUAN369 ship_cnname: 皖鸿远369 data_source: 0 ship_type: 70 length: 68 width: 13 left: 8 trail: 18 draught: 4.8 dest: TAIZHOU,CN destcode: CNTZO eta: 1745827548 navistat: 0 lat: 32.192517 lng: 119.628093 sog: 6.2 cog: 80.8 hdg: 511 rot: 0 last_time: 1745827548 headers: {} x-apifox-name: success security: [] x-apifox-folder: 1 AIS Dataset/1.1 Vessel Position x-apifox-status: released x-run-in-apifox: https://app.apifox.com/web/project/7948067/apis/api-428990613-run operationId: getV1AISVesselPositionSingle x-operation-id-source: derived x-evidence: harvested: '2026-08-09' index: https://docs.shipfinder.com/llms.txt index_http_status: 200 fragments: 40 note: Each path item was extracted verbatim from the "## OpenAPI Specification" yaml block on the corresponding docs page. The provider publishes no consolidated OpenAPI document. sources: - path: /v1/AIS/FleetPosition method: GET title: 1.1.3 Fleet Position source: https://docs.shipfinder.com/430293359e0.md - path: /v1/AIS/VesselFlagInfo method: GET title: 1.5 Vessel Flag Information source: https://docs.shipfinder.com/429919472e0.md - path: /v1/AIS/VesselPositionMulti method: GET title: 1.1.2 Multi-vessel Position source: https://docs.shipfinder.com/430292321e0.md - path: /v1/AIS/VesselPositionSingle method: GET title: 1.1.1 Single Vessel Position source: https://docs.shipfinder.com/428990613e0.md - path: /v1/AIS/VesselSearch method: GET title: 1.2 Vessel Search source: https://docs.shipfinder.com/428749512e0.md - path: /v1/AIS/VesselsInZone method: GET title: 1.4 Vessels in Zone source: https://docs.shipfinder.com/429583708e0.md - path: /v1/AIS/VesselsNearby method: GET title: 1.3 Vessels Nearby source: https://docs.shipfinder.com/429003024e0.md - path: /v1/Event/AddFleet method: POST title: 7.1.1 Create Fleet source: https://docs.shipfinder.com/432035260e0.md - path: /v1/Event/AddGeofence method: POST title: 7.2.1 Geofence Creation source: https://docs.shipfinder.com/433382008e0.md - path: /v1/Event/AddVesselSpeedAlert method: POST title: 7.3.1 Add Vessel Speed Alert Subscription source: https://docs.shipfinder.com/433460139e0.md - path: /v1/Event/AddVesselToFleet method: POST title: 7.1.5 Add Vessels to Fleet source: https://docs.shipfinder.com/432100231e0.md - path: /v1/Event/DeleteFleet method: POST title: 7.1.4 Delete Fleet source: https://docs.shipfinder.com/432076110e0.md - path: /v1/Event/DeleteFleetVessel method: POST title: 7.1.7 Remove Vessels from Fleet source: https://docs.shipfinder.com/432106004e0.md - path: /v1/Event/DeleteGeofence method: DELETE title: 7.2.4 Geofence Deletion source: https://docs.shipfinder.com/433422419e0.md - path: /v1/Event/DeleteVesselSpeedAlert method: POST title: 7.3.2 Delete Vessel Speed Alert Subscription source: https://docs.shipfinder.com/433471968e0.md - path: /v1/Event/GetFleet method: GET title: 7.1.3 Query Fleet source: https://docs.shipfinder.com/432057101e0.md - path: /v1/Event/GetGeofence method: GET title: 7.2.3 Geofence Query source: https://docs.shipfinder.com/433414777e0.md - path: /v1/Event/UpdateFleetInfo method: POST title: 7.1.2 Update Fleet Information source: https://docs.shipfinder.com/432048484e0.md - path: /v1/Event/UpdateFleetVessel method: POST title: 7.1.6 Batch Update Vessels in Fleet source: https://docs.shipfinder.com/432080706e0.md - path: /v1/Event/UpdateGeofence method: POST title: 7.2.2 Geofence Update source: https://docs.shipfinder.com/433396710e0.md - path: /v1/Event/VesselSpeedAlertList method: GET title: 7.3.3 Query Vessel Speed Alert Subscription List source: https://docs.shipfinder.com/433473614e0.md - path: /v1/History/PortCallRecordsByPort method: GET title: 3.6 Port Calls Records for Port source: https://docs.shipfinder.com/430531632e0.md - path: /v1/History/PortCallRecordsByVessel method: GET title: 3.3 Vessel Port Call History source: https://docs.shipfinder.com/430426234e0.md - path: /v1/History/PortCallRecordsByVesselAtPort method: GET title: 3.4 Vessel Port Call Records at Specific Port source: https://docs.shipfinder.com/430484162e0.md - path: /v1/History/VesselCurrentPortCall method: GET title: 3.5 Vessel Current Port Call source: https://docs.shipfinder.com/430498718e0.md - path: /v1/History/VesselHistoryTrack method: GET title: 3.1 Vessel History Track source: https://docs.shipfinder.com/430346103e0.md - path: /v1/History/VesselStsEvents method: GET title: 3.2 Ship-to-Ship (STS) Events source: https://docs.shipfinder.com/430352093e0.md - path: /v1/Meteorology/CycloneInfo method: GET title: 5.1.2 Tropical Cyclone Details by Point source: https://docs.shipfinder.com/431698143e0.md - path: /v1/Meteorology/CyclonesList method: GET title: 5.1.1 Global Tropical Cyclones List source: https://docs.shipfinder.com/431698053e0.md - path: /v1/Meteorology/MarineWeather method: GET title: 5.3 Global Marine Weather source: https://docs.shipfinder.com/431272522e0.md - path: /v1/Meteorology/TideStationInfo method: GET title: 5.2.2 Query Single Tide Gauge Station Details source: https://docs.shipfinder.com/431865286e0.md - path: /v1/Meteorology/TideStationList method: GET title: 5.2.1 Request parameters for Global Tide Gauge Stations List source: https://docs.shipfinder.com/431857907e0.md - path: /v1/Prediction/ETA method: GET title: 4.3 ETA Query source: https://docs.shipfinder.com/431244206e0.md - path: /v1/Prediction/RoutePlanPointToPoint method: GET title: 4.1 Point-to-Point Route Planning source: https://docs.shipfinder.com/431124483e0.md - path: /v1/Prediction/RoutePlanPortToPort method: GET title: 4.2 Port-to-Port Route Planning source: https://docs.shipfinder.com/431244012e0.md - path: /v1/Voyage/PortAnchoredVessels method: GET title: 2.3 Currently Anchored Vessels source: https://docs.shipfinder.com/430236145e0.md - path: /v1/Voyage/PortBerthedVessels method: GET title: 2.2 Currently Berthed Vessels source: https://docs.shipfinder.com/430197412e0.md - path: /v1/Voyage/PortExpectedArrivals method: GET title: 2.4 Inbound / Expected Arrivals source: https://docs.shipfinder.com/430249182e0.md - path: /v1/Voyage/PortInfo method: GET title: 2.1 Port Information source: https://docs.shipfinder.com/429932201e0.md - path: /v1/Warning/NavigationalWarnings method: GET title: 6.1 China Region Navigational Warnings source: https://docs.shipfinder.com/431872073e0.md