openapi: 3.2.0 info: title: ShipFinder Global Maritime Data 5 Meteorology Dataset/5.2… 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: 5 Meteorology Dataset/5.2 Global Port Tide Predictions paths: /v1/Meteorology/TideStationInfo: get: summary: 5.2.2 Query Single Tide Gauge Station Details deprecated: false description: '' tags: - 5 Meteorology Dataset/5.2 Global Port Tide Predictions parameters: - name: key in: query description: Your personal Shipfinderer API key to verify service permissions required: true example: 1F6D701272402D1E7D8D316CCE519123 schema: type: string - name: port_code in: query description: Unique ID of the port tide gauge station required: true example: 4000189 schema: type: integer - name: start_date in: query description: 'Start date for tidal data query. Format: YYYY-MM-DD. Historical data queries are supported from 2020 onwards.' required: true example: '2025-03-01' schema: type: string - name: end_date in: query description: "End date for tidal data query. Format: YYYY-MM-DD. \nNotes:\n1. Single query time range shall not exceed 90 days.\n2. Forecast data is limited to 30 days in advance; requests beyond this range will return an error.\n3. Historical tidal data is available for all dates from 2020 onwards.\n4. Tidal data is updated once daily.\n5. Future timestamps return forecast data; historical timestamps are overwritten with observed tidal data." required: true example: '2025-03-05' schema: type: string responses: '0': description: '' content: application/json: schema: type: object properties: status: type: integer msg: type: string data: type: object properties: overview: type: array items: type: object properties: tide_date: type: string description: Calendar date of tidal records tide_time1: type: string description: First tidal time point on the query date tide_time2: type: string description: Second tidal time point on the query date tide_time3: type: string description: Third tidal time point on the query date tide_time4: type: string description: Fourth tidal time point on the query date tide_height1: type: number description: 'Tidal height at the first time point, Unit: meters (m)' tide_height2: type: number description: 'Tidal height at the second time point, Unit: meters (m)' tide_height3: type: number description: 'Tidal height at the third time point, Unit: meters (m)' tide_height4: type: number description: 'Tidal height at the fourth time point, Unit: meters (m)' tide_lowhigh1: type: string description: Stage label for the first tidal event (e.g., High Tide, Low Tide) tide_lowhigh2: type: string description: Stage label for the second tidal event (e.g., High Tide, Low Tide) tide_lowhigh3: type: string description: Stage label for the third tidal event (e.g., High Tide, Low Tide) tide_lowhigh4: type: string description: Stage label for the fourth tidal event (e.g., High Tide, Low Tide) required: - tide_date - tide_time1 - tide_time2 - tide_time3 - tide_time4 - tide_height1 - tide_height2 - tide_height3 - tide_height4 - tide_lowhigh1 - tide_lowhigh2 - tide_lowhigh3 - tide_lowhigh4 x-apifox-orders: - tide_date - tide_time1 - tide_time2 - tide_time3 - tide_time4 - tide_height1 - tide_height2 - tide_height3 - tide_height4 - tide_lowhigh1 - tide_lowhigh2 - tide_lowhigh3 - tide_lowhigh4 detail: type: array items: type: object properties: tide_date: type: string description: Tide Date h0: type: number description: 'Tidal height at 00:00 midnight, Unit: meters (m)' h1: type: number description: 'Tidal height at 01:00 midnight, Unit: meters (m)' h2: type: number description: 'Tidal height at 02:00 midnight, Unit: meters (m)' h3: type: number description: 'Tidal height at 03:00 midnight, Unit: meters (m)' h4: type: number description: 'Tidal height at 04:00 midnight, Unit: meters (m)' h5: type: number description: 'Tidal height at 05:00 midnight, Unit: meters (m)' h6: type: number description: 'Tidal height at 06:00 midnight, Unit: meters (m)' h7: type: number description: 'Tidal height at 07:00 midnight, Unit: meters (m)' h8: type: number description: 'Tidal height at 08:00 midnight, Unit: meters (m)' h9: type: number description: 'Tidal height at 09:00 midnight, Unit: meters (m)' h10: type: number description: 'Tidal height at 10:00 midnight, Unit: meters (m)' h11: type: number description: 'Tidal height at 11:00 midnight, Unit: meters (m)' h12: type: number description: 'Tidal height at 12:00 midnight, Unit: meters (m)' h13: type: number description: 'Tidal height at 13:00 midnight, Unit: meters (m)' h14: type: number description: 'Tidal height at 14:00 midnight, Unit: meters (m)' h15: type: number description: 'Tidal height at 15:00 midnight, Unit: meters (m)' h16: type: number description: 'Tidal height at 16:00 midnight, Unit: meters (m)' h17: type: number description: 'Tidal height at 17:00 midnight, Unit: meters (m)' h18: type: number description: 'Tidal height at 18:00 midnight, Unit: meters (m)' h19: type: number description: 'Tidal height at 19:00 midnight, Unit: meters (m)' h20: type: number description: 'Tidal height at 20:00 midnight, Unit: meters (m)' h21: type: number description: 'Tidal height at 21:00 midnight, Unit: meters (m)' h22: type: number description: 'Tidal height at 22:00 midnight, Unit: meters (m)' h23: type: number description: 'Tidal height at 23:00 midnight, Unit: meters (m)' required: - tide_date - h0 - h1 - h2 - h3 - h4 - h5 - h6 - h7 - h8 - h9 - h10 - h11 - h12 - h13 - h14 - h15 - h16 - h17 - h18 - h19 - h20 - h21 - h22 - h23 x-apifox-orders: - tide_date - h0 - h1 - h2 - h3 - h4 - h5 - h6 - h7 - h8 - h9 - h10 - h11 - h12 - h13 - h14 - h15 - h16 - h17 - h18 - h19 - h20 - h21 - h22 - h23 required: - overview - detail x-apifox-orders: - overview - detail required: - status - msg - data x-apifox-orders: - status - msg - data example: status: 0 msg: '' data: overview: - tide_date: '2025-03-05' tide_time1: 00:10 tide_time2: 06:33 tide_time3: '12:43' tide_time4: '19:12' tide_height1: 3.8 tide_height2: 0.1 tide_height3: 4.2 tide_height4: 0.6 tide_lowhigh1: high tide 1 tide_lowhigh2: low tide 2 tide_lowhigh3: high tide 3 tide_lowhigh4: low tide 4 - tide_date: '2025-03-04' tide_time1: 05:55 tide_time2: '11:56' tide_time3: '18:22' tide_time4: ' ' tide_height1: 0 tide_height2: 4.2 tide_height3: 0.3 tide_height4: 0 tide_lowhigh1: low tide 1 tide_lowhigh2: high tide 2 tide_lowhigh3: high tide 3 tide_lowhigh4: high tide 4 - tide_date: '2025-03-03' tide_time1: 05:19 tide_time2: '11:13' tide_time3: '17:38' tide_time4: '23:29' tide_height1: 0 tide_height2: 4.1 tide_height3: 0.1 tide_height4: 4.1 tide_lowhigh1: low tide 1 tide_lowhigh2: high tide 2 tide_lowhigh3: low tide 3 tide_lowhigh4: high tide 4 - tide_date: '2025-03-02' tide_time1: 04:44 tide_time2: '10:33' tide_time3: '16:55' tide_time4: '22:51' tide_height1: 0.1 tide_height2: 4 tide_height3: 0 tide_height4: 4.2 tide_lowhigh1: low tide 1 tide_lowhigh2: high tide 2 tide_lowhigh3: low tide 3 tide_lowhigh4: high tide 4 - tide_date: '2025-03-01' tide_time1: 04:10 tide_time2: 09:56 tide_time3: '16:14' tide_time4: '22:14' tide_height1: 0.2 tide_height2: 3.8 tide_height3: 0 tide_height4: 4.3 tide_lowhigh1: low tide 1 tide_lowhigh2: high tide 2 tide_lowhigh3: low tide 3 tide_lowhigh4: high tide 4 detail: - tide_date: '2025-03-05' h0: 3.79 h1: 3.64 h2: 3.1 h3: 2.31 h4: 1.44 h5: 0.65 h6: 0.14 h7: 0.11 h8: 0.64 h9: 1.57 h10: 2.62 h11: 3.52 h12: 4.07 h13: 4.17 h14: 3.86 h15: 3.22 h16: 2.4 h17: 1.59 h18: 0.92 h19: 0.6 h20: 0.75 h21: 1.3 h22: 2.04 h23: 2.77 - tide_date: '2025-03-04' h0: 3.99 h1: 3.53 h2: 2.74 h3: 1.81 h4: 0.91 h5: 0.22 h6: -0.03 h7: 0.33 h8: 1.2 h9: 2.29 h10: 3.29 h11: 3.98 h12: 4.2 h13: 3.95 h14: 3.32 h15: 2.45 h16: 1.56 h17: 0.78 h18: 0.33 h19: 0.41 h20: 1 h21: 1.87 h22: 2.78 h23: 3.47 - tide_date: '2025-03-03' h0: 3.9 h1: 3.2 h2: 2.28 h3: 1.32 h4: 0.49 h5: 0.02 h6: 0.14 h7: 0.84 h8: 1.87 h9: 2.93 h10: 3.73 h11: 4.1 h12: 3.97 h13: 3.41 h14: 2.56 h15: 1.64 h16: 0.79 h17: 0.21 h18: 0.14 h19: 0.67 h20: 1.59 h21: 2.63 h22: 3.5 h23: 3.99 - tide_date: '2025-03-02' h0: 3.62 h1: 2.76 h2: 1.8 h3: 0.9 h4: 0.26 h5: 0.11 h6: 0.57 h7: 1.46 h8: 2.48 h9: 3.35 h10: 3.87 h11: 3.9 h12: 3.48 h13: 2.71 h14: 1.8 h15: 0.93 h16: 0.25 h17: 0.01 h18: 0.38 h19: 1.25 h20: 2.35 h21: 3.36 h22: 4.04 h23: 4.22 - tide_date: '2025-03-01' h0: 3.2 h1: 2.29 h2: 1.38 h3: 0.62 h4: 0.25 h5: 0.44 h6: 1.11 h7: 2.02 h8: 2.9 h9: 3.54 h10: 3.75 h11: 3.49 h12: 2.85 h13: 2.01 h14: 1.15 h15: 0.42 h16: 0.04 h17: 0.21 h18: 0.94 h19: 2 h20: 3.1 h21: 3.92 h22: 4.31 h23: 4.18 headers: {} x-apifox-name: success security: [] x-apifox-folder: 5 Meteorology Dataset/5.2 Global Port Tide Predictions x-apifox-status: released x-run-in-apifox: https://app.apifox.com/web/project/7948067/apis/api-431865286-run operationId: getV1MeteorologyTideStationInfo x-operation-id-source: derived /v1/Meteorology/TideStationList: get: summary: 5.2.1 Request parameters for Global Tide Gauge Stations List deprecated: false description: '' tags: - 5 Meteorology Dataset/5.2 Global Port Tide Predictions parameters: - name: key in: query description: Your personal Shipfinderer API key to verify service permissions required: true example: 1F6D701272402D1E7D8D316CCE519123 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: port_code: type: integer description: Port Tidal Observation Station ID port_cnname: type: string description: Chinese name of the port port_name: type: string description: Name of the port port_country_cnname: type: string description: Chinese name of the country/region where the port is located port_country_name: type: string description: Name of the country/region where the port is located lat: type: number description: Coordinate latitude, WGS84 coordinate system lng: type: number description: Coordinate longitude, WGS84 coordinate system port_time_zone: type: string description: Time zone of the port’s location datumn: type: number description: 'Vertical offset of the tidal datum below mean sea level, Unit: centimeters (cm)' required: - port_code - port_cnname - port_name - port_country_cnname - port_country_name - lat - lng - port_time_zone - datumn x-apifox-orders: - port_code - port_cnname - port_name - port_country_cnname - port_country_name - lat - lng - port_time_zone - datumn required: - status - msg - total - data x-apifox-orders: - status - msg - total - data example: "{\n \"status\": 0,\n \"msg\": \"\",\n \"total\": 4708,\n \"data\": [\n {\n \"port_code\": 4001466,\n \"port_cnname\": \"\",\n \"port_name\": \"Camocim\",\n \"port_country_cnname\": \"巴西\",\n \"port_country_name\": \"Brazil\",\n \"lat\": -2.88333,\n \"lng\": -40.85,\n \"port_time_zone\": \"UTC-3\",\n \"datumn\": \"182\"\n },\n {\n \"port_code\": 8000001,\n \"port_cnname\": \"丹东\",\n \"port_name\": \"DANDONG\",\n \"port_country_cnname\": \"中国\",\n \"port_country_name\": \"China\",\n \"lat\": 40.11667,\n \"lng\": 124.4,\n \"port_time_zone\": \"UTC+8\",\n \"datumn\": \"150\"\n },\n ......\n ]\n}" headers: {} x-apifox-name: success security: [] x-apifox-folder: 5 Meteorology Dataset/5.2 Global Port Tide Predictions x-apifox-status: released x-run-in-apifox: https://app.apifox.com/web/project/7948067/apis/api-431857907-run operationId: getV1MeteorologyTideStationList 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