{"components":{"parameters":{"BGCVariable":{"description":"The biogeochemistry variable to request. <br> Key: <br> chl: mass concentration of chlorophyll a in sea water (mg m-3)<br> dissic: mole concentration of dissolved inorganic carbon in sea water (mol m-3)<br> fe: mole concentration of dissolved iron in sea water (mmol m-3)<br> no3: mole concentration of nitrate in sea water (mmol m-3)<br> nppv: net primary production of biomass expressed as carbon per unit volume in sea water (mg m-3 day-1)<br> o2: mole concentration of dissolved molecular oxygen in sea water (mmol m-3)<br> ph: sea water pH recorded on total scale<br> phyc: mole concentration of phytoplankton expressed as carbon in sea water (mmol m-3)<br> po4: mole concentration of phosphate in sea water (mmol m-3)<br> si: mole concentration of silicate in sea water (mmol m-3)<br> spco2: surface partial pressure of carbon dioxide in sea water (Pa)<br> talk: sea water alkalinity expressed as mole equivalent (mol m-3)\n","in":"query","name":"variable","required":true,"schema":{"enum":["chl","dissic","fe","no3","nppv","o2","ph","phyc","po4","si","spco2","talk"],"example":"chl","type":"string"}},"Day":{"description":"Day in DD format","in":"query","name":"day","required":true,"schema":{"example":1,"type":"integer"}},"Depth":{"description":"Depth (in m). Supported values are: 0, 10, 20, 30, 50, 75, 100, 125, 150, 200, 250, 300, 400, 500, 600, 700, 800, 900, 1000, 1100, 1200, 1300, 1400, 1500, 1750, 2000, 2500, 3000, 3500, 4000, 4500, 5000, 5500. Unsupported values will be rounded to the closest value.\n","in":"query","name":"depth","required":true,"schema":{"example":30,"type":"number"}},"Latitude":{"description":"Geocentric latitude (deg): -90 to 90","in":"query","name":"latitude","required":true,"schema":{"example":-34.0,"type":"number"}},"Longitude":{"description":"Geocentric longitude (deg): -180 to 180 (0 to 360 also accepted)","in":"query","name":"longitude","required":true,"schema":{"example":152.0,"type":"number"}},"Month":{"description":"Month in MM format","in":"query","name":"month","required":true,"schema":{"example":1,"type":"integer"}},"PhysVariable":{"description":"The physical variable to request. <br> Key: <br> thetao: Potential temperature \u00b0C<br> so: Salinity (PSU)<br> uo: Eastward ocean current velocity (m/s)<br> vo: Northward ocean current velocity (m/s)<br> wo: Upward sea water velocity (m/s)<br> zos: Sea surface height above geoid (m)<br>\n","in":"query","name":"variable","required":true,"schema":{"enum":["thetao","so","uo","vo","wo","zos"],"example":"so","type":"string"}},"WaveVariable":{"description":"The wave variable to request. <br> Key: <br> VHM0: Spectral significant wave height (m)<br> VTM10: Spectral moments (-1,0) wave period (Tm-10) (s)<br> VTM02: Spectral moments (0,2) wave period (Tm02) (s)<br> VTPK: Wave period at spectral peak / peak period (s)<br> VMDR: Mean wave direction from (Mdir) (degree)<br> VPED: Wave principal direction at spectral peak (degree)<br> VCMX: Maximum crest trough wave height (Hc,max) (m)<br> VSDX: Stokes drift U (m/s)<br> VSDY: Stokes drift V (m/s)<br> VHM0_WW: Spectral significant wind wave height (m)<br> VTM01_WW: Spectral moments (0,1) wind wave period (s)<br> VMDR_WW: Mean wind wave direction from (degree)<br> VHM0_SW1: Spectral significant primary swell wave height (m)<br> VTM01_SW1: Spectral moments (0,1) primary swell wave period (s)<br> VMDR_SW1: Mean primary swell wave direction from (degree)<br> VHM0_SW2: Spectral significant secondary swell wave height (m)<br> VTM01_SW2: Spectral moments (0,1) secondary swell wave period (s)<br> VMDR_SW2: Mean secondary swell wave direction from (degree)<br>\n","in":"query","name":"variable","required":true,"schema":{"enum":["VHM0","VTM10","VTM02","VTPK","VMDR","VPED","VCMX","VSDX","VSDY","VHM0_WW","VTM01_WW","VMDR_WW","VHM0_SW1","VTM01_SW1","VMDR_SW1","VHM0_SW2","VTM01_SW2","VMDR_SW2"],"example":"VHM0","type":"string"}},"Year":{"description":"Year in YYYY format","in":"query","name":"year","required":true,"schema":{"example":2024,"type":"integer"}}}},"info":{"description":"The OECD predicts the value added by the Ocean economy will reach 3 Trillion USD by 2030.  Better access to marine forecasting and other oceanographic data can help improve the  safety, efficiency, and sustainability of shipping, fisheries, offshore infrastructure, marine protected areas, and other maritime activities.\nWe provide web API access to the oceanographic data sources below.\n<br><br>\nAPI requests must contain a key \"API-Key\" in the header (see code samples). <br><br> \nVisit our <Button to='#' transparent><a href='https://developer.amentum.io'>Developer Portal</a></Button> to obtain a key with a 14 day free trial. Commercial subscriptions are covered by a Service Level Agreement.<br><br> \nAmentum Pty Ltd is not responsible nor liable for any loss or damage of any sort incurred as a result of using the API. <br><br>\nCopyright <a href='https://amentum.space'>Amentum Pty Ltd</a> 2026.\n","title":"Ocean API","version":"1.3.0","x-logo":{"altText":"Amentum Aerospace","backgroundColor":"#FFFFFF","url":"https://amentum.io/static/img/AMENTUMSPACE_GREY_SMALL.jpg"}},"openapi":"3.0.0","paths":{"/ausseabed":{"get":{"operationId":"app.api_ausseabed.endpoints.AusSeabed_Bathymetry.point","parameters":[{"$ref":"#/components/parameters/Latitude"},{"$ref":"#/components/parameters/Longitude"}],"responses":{"200":{"content":{"application/json":{"schema":{"example":{"elevation":{"units":"m","value":-430.57916259765625},"point":{"latitude":-27.566410531111,"longitude":155.20208537965115}},"properties":{"elevation":{"description":"Elevation above average ocean height in meters. Null indicates missing data.\n","properties":{"units":{"type":"string"},"value":{"nullable":true,"type":"number"}},"type":"object"},"point":{"description":"The point in the AusSeabed dataset nearest to the request.\n","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"type":"object"}},"type":"object"}}},"description":"Successful AusSeabed bathymetry lookup"},"408":{"content":{"application/json":{"schema":{"example":{"error":"Latitude must be in bound (-60.0, -8.0)"},"properties":{"error":{"type":"string"}},"type":"object"}}},"description":"AusSeabed dataset lookup failed"}},"summary":"Look up Australian bathymetry high res survey data as elevation for given coordinates.\n","tags":["ausseabed"],"x-codeSamples":[{"lang":"Shell","source":"curl -X GET \"https://ocean.amentum.io/ausseabed?latitude=-27.5664&longitude=155.2021\" -H \"accept: application/json\" -H \"API-Key: <your_key>\" \n"}]}},"/gebco":{"get":{"operationId":"app.api_bathymetry.endpoints.GEBCO_Bathymetry.point","parameters":[{"$ref":"#/components/parameters/Latitude"},{"$ref":"#/components/parameters/Longitude"}],"responses":{"200":{"content":{"application/json":{"schema":{"example":{"elevation":{"units":"m","value":-10907},"point":{"latitude":11.372916666666669,"longitude":142.59375}},"properties":{"elevation":{"description":"Elevation above average ocean height to the nearest meter.\n","properties":{"units":{"type":"string"},"value":{"type":"number"}},"type":"object"},"point":{"description":"The given point in the request.\n","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"type":"object"}},"type":"object"}}},"description":"Successful GEBCO Bathymetry lookup"}},"summary":"Look up bathymetry data as elevation for given coordinates.\n","tags":["gebco"],"x-codeSamples":[{"lang":"Shell","source":"curl -X GET \"https://ocean.amentum.io/gebco?latitude=11.373&longitude=142.592\" -H \"accept: application/json\" -H \"API-Key: <your_key>\" \n"}]}},"/mfwam":{"get":{"operationId":"app.api_nemo.endpoints.MFWAM.point","parameters":[{"$ref":"#/components/parameters/Year"},{"$ref":"#/components/parameters/Month"},{"$ref":"#/components/parameters/Day"},{"$ref":"#/components/parameters/Latitude"},{"$ref":"#/components/parameters/Longitude"},{"$ref":"#/components/parameters/WaveVariable"}],"responses":{"200":{"content":{"application/json":{"schema":{"example":{"long_name":"sea_surface_wave_significant_height","point":{"depth":0,"latitude":11.333333333333329,"longitude":142.5},"units":"m","value":2.1499998569488525},"properties":{"long_name":{"type":"string"},"point":{"description":"The given point in the request.\n","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"type":"object"},"units":{"type":"string"},"value":{"type":"number"}},"type":"object"}}},"description":"Successful MFWAM wave lookup"}},"summary":"Look up forecast or hindcast wave variable for given latitude, longitude, and date\n","tags":["mfwam"],"x-codeSamples":[{"lang":"Shell","source":"curl -X GET \"https://ocean.amentum.io/mfwam?year=2024&month=1&day=1&latitude=11.373&longitude=142.492&variable=VHM0\" -H \"accept: application/json\" -H \"API-Key: <your_key>\"\n"}]}},"/nemo/bgc":{"get":{"operationId":"app.api_nemo.endpoints.NEMO.point","parameters":[{"$ref":"#/components/parameters/Year"},{"$ref":"#/components/parameters/Month"},{"$ref":"#/components/parameters/Day"},{"$ref":"#/components/parameters/Latitude"},{"$ref":"#/components/parameters/Longitude"},{"$ref":"#/components/parameters/Depth"},{"$ref":"#/components/parameters/BGCVariable"}],"responses":{"200":{"content":{"application/json":{"schema":{"example":{"long_name":"mass_concentration_of_chlorophyll_a_in_sea_water","point":{"depth":9.572997093200684,"latitude":11.25,"longitude":142.5},"units":"mg m-3","value":0.0647776797413826},"properties":{"long_name":{"type":"string"},"point":{"description":"The given point in the request.\n","properties":{"depth":{"type":"number"},"latitude":{"type":"number"},"longitude":{"type":"number"}},"type":"object"},"units":{"type":"string"},"value":{"type":"number"}},"type":"object"}}},"description":"Successful NEMO lookup"}},"summary":"Look up forecast or hindcast biogeochemistry variable for given latitude, longitude, depth, and date\n","tags":["nemo"],"x-codeSamples":[{"lang":"Shell","source":"curl -X GET \"https://ocean.amentum.io/nemo/bgc?year=2024&month=1&day=1&latitude=11.373&longitude=142.492&depth=10&variable=chl\" -H \"accept: application/json\" -H \"API-Key: <your_key>\" \n"}]}},"/nemo/phys":{"get":{"operationId":"app.api_nemo.endpoints.NEMO_Phys.point","parameters":[{"$ref":"#/components/parameters/Year"},{"$ref":"#/components/parameters/Month"},{"$ref":"#/components/parameters/Day"},{"$ref":"#/components/parameters/Latitude"},{"$ref":"#/components/parameters/Longitude"},{"$ref":"#/components/parameters/Depth"},{"$ref":"#/components/parameters/PhysVariable"}],"responses":{"200":{"content":{"application/json":{"schema":{"example":{"long_name":"sea_water_potential_temperature","point":{"depth":142.5,"latitude":11.333335876464844,"longitude":0},"units":"degrees_C","value":28.877975463867188},"properties":{"long_name":{"type":"string"},"point":{"description":"The given point in the request.\n","properties":{"depth":{"type":"number"},"latitude":{"type":"number"},"longitude":{"type":"number"}},"type":"object"},"units":{"type":"string"},"value":{"type":"number"}},"type":"object"}}},"description":"Successful NEMO physical lookup"}},"summary":"Look up forecast or hindcast physical variable for given latitude, longitude, depth, and date\n","tags":["nemo"],"x-codeSamples":[{"lang":"Shell","source":"curl -X GET \"https://ocean.amentum.io/nemo/phys?year=2024&month=1&day=1&latitude=11.373&longitude=142.492&depth=10&variable=thetao\" -H \"accept: application/json\" -H \"API-Key: <your_key>\" \n"}]}},"/rtofs":{"get":{"operationId":"app.api_oceans.endpoints.Oceans.point","parameters":[{"$ref":"#/components/parameters/Latitude"},{"$ref":"#/components/parameters/Longitude"},{"$ref":"#/components/parameters/Depth"}],"responses":{"200":{"content":{"application/json":{"schema":{"example":{"current_u":{"units":"m/s","value":0.22920776903629303},"current_v":{"units":"m/s","value":0.35265854001045227},"point":{"depth":30.0,"latitude":-34.04350280761719,"longitude":151.977294921875,"on_land":false},"salinity":{"units":"g/kg","value":35.502235412597656},"temperature":{"units":"deg C","value":23.43114471435547}},"properties":{"current_u":{"description":"Eastward component of sea water velocity, in meters per second.\n","properties":{"units":{"type":"string"},"value":{"type":"number"}},"type":"object"},"current_v":{"description":"Northward component of sea water velocity, in meters per second.\n","properties":{"units":{"type":"string"},"value":{"type":"number"}},"type":"object"},"point":{"description":"The given point in the request.\n","properties":{"depth":{"type":"number"},"latitude":{"type":"number"},"longitude":{"type":"number"},"on_land":{"type":"boolean"}},"type":"object"},"salinity":{"description":"Sea water salinity, in grams per kilogram of water.\n","properties":{"units":{"type":"string"},"value":{"type":"number"}},"type":"object"},"temperature":{"description":"Temperature, in degrees celsius.\n","properties":{"units":{"type":"string"},"value":{"type":"number"}},"type":"object"}},"type":"object"}}},"description":"Successful RTOFS lookup"},"408":{"content":{"application/json":{"schema":{"example":{"error":"salinity dataset was not ready. It is likely it is being downloaded right now, and will be available soon."},"properties":{"error":{"description":"Description of what might be the cause of the timeout\n","type":"string"}},"type":"object"}}},"description":"Reading data timed out"}},"summary":"Get the temperature, salinity, and current vector components\n","tags":["rtofs"],"x-codeSamples":[{"lang":"Shell","source":"curl -X GET \"https://ocean.amentum.io/rtofs?latitude=-34.0&longitude=152.0&depth=30\" -H \"accept: application/json\" -H \"API-Key: <your_key>\" \n"}]}},"/speed-sound":{"get":{"operationId":"app.api_derived.endpoints.SoundSpeed.point","parameters":[{"$ref":"#/components/parameters/Year"},{"$ref":"#/components/parameters/Month"},{"$ref":"#/components/parameters/Day"},{"$ref":"#/components/parameters/Latitude"},{"$ref":"#/components/parameters/Longitude"},{"$ref":"#/components/parameters/Depth"}],"responses":{"200":{"content":{"application/json":{"schema":{"example":{"point":{"depth":29.444730758666992,"latitude":-34.0,"longitude":152.0},"salinity":{"long_name":"sea_water_salinity","units":"PSU","value":35.502235412597656},"sound_speed":{"method":"Mackenzie","units":"m/s","value":1531.5079112959672},"temperature":{"long_name":"sea_water_potential_temperature","units":"deg C","value":23.43114471435547}},"properties":{"point":{"description":"The nearest NEMO physical point used for temperature and sound speed.\n","properties":{"depth":{"type":"number"},"latitude":{"type":"number"},"longitude":{"type":"number"}},"type":"object"},"salinity":{"description":"Salinity used in the calculation, in PSU.\n","properties":{"long_name":{"type":"string"},"units":{"type":"string"},"value":{"type":"number"}},"type":"object"},"sound_speed":{"description":"Speed of sound in seawater calculated using Mackenzie's equation.\n","properties":{"method":{"type":"string"},"units":{"type":"string"},"value":{"type":"number"}},"type":"object"},"temperature":{"description":"Temperature used in the calculation, in degrees celsius.\n","properties":{"long_name":{"type":"string"},"units":{"type":"string"},"value":{"type":"number"}},"type":"object"}},"type":"object"}}},"description":"Successful seawater sound speed calculation"},"408":{"content":{"application/json":{"schema":{"example":{"error":"Could not calculate sound speed because missing values were returned for: salinity."},"properties":{"error":{"description":"Description of what caused the calculation to fail.\n","type":"string"}},"type":"object"}}},"description":"Reading data failed or required values were missing"}},"summary":"Calculate the speed of sound in seawater using Mackenzie's equation\n","tags":["speed-sound"],"x-codeSamples":[{"lang":"Shell","source":"curl -X GET \"https://ocean.amentum.io/speed-sound?year=2024&month=1&day=1&latitude=-34.0&longitude=152.0&depth=30\" -H \"accept: application/json\" -H \"API-Key: <your_key>\" \n"}]}}},"servers":[{"url":""}],"tags":[{"description":"The Global Real-Time Ocean Forecast System  (<a href=\"https://polar.ncep.noaa.gov/global/about/GODAE_poster.shtml\">Global RTOFS</a>) developed by the  US National Weather Service in association with the US Navy.\nThe global RTOFS is based on an eddy resolving 1/12\u00b0 global HYCOM (HYbrid Coordinates Ocean Model). <br><br>\nThe API fetches daily nowcasts and returns temperature, salinity, and ocean current components for any point using nearest neighbour interpolation. The actual coordinates of the datapoint  are returned in the JSON, along with a boolean flag to indicate if the point is over land. If the point is over  land, the values will be null. Please note any responses over land will count toward the quota usage, we are working on implementing a method to return the nearest point  over ocean.  <br><br>\nVisit our <Button to='#' transparent><a href='https://developer.amentum.io'>Developer Portal</a></Button> to obtain an API key with a 14 day free trial.\n","name":"rtofs","x-displayName":"RTOFS Forecasts"},{"description":"The General Bathymetric Chart of the Oceans  (<a href=\"https://www.gebco.net\">GEBCO</a>) - which aims to be the most authoritative publicly  available baythmetry datasets of the world's oceans. GEBCO releases a new grid each year. The API provides access to the 2025 version. \nThe grid provides global coverage of elevation data in meters, including  over land and ice, and is relative to the WGS84. Elevations refer to Mean Sea Level. More information on the grid can be found  <a href=\"https://www.gebco.net/data-products-gridded-bathymetry-data/gebco2025-grid\"> here</a>. <br><br> The API returns the elevation (NOTE: depth is equal to negative elevation) along with  the nearest neighbour coordinates on the GEBCO grid to the coordinates requested. <br><br>\nVisit our <Button to='#' transparent><a href='https://developer.amentum.io'>Developer Portal</a></Button> to obtain an API key with a 14 day free trial.\n","name":"gebco","x-displayName":"GEBCO Bathymetry"},{"description":"The AusSeabed multibeam bathymetry compilation for Australian waters.\nThe current endpoint serves the 2018 50 m multibeam bathymetry raster and returns the nearest available elevation in meters for the requested coordinates. Inland and unmapped areas may return a null elevation value. <br><br>\nVisit our <Button to='#' transparent><a href='https://developer.amentum.io'>Developer Portal</a></Button> to obtain an API key with a 14 day free trial.\n","name":"ausseabed","x-displayName":"AusSeabed Bathymetry"},{"description":"NEMO (Nucleus for European Modelling of the Ocean) is a general model of ocean circulation that is composed of several models, including the NEMO-TOP/PISCES model of biogeochemistry. This API endpoint provides access to the Operational Mercator-Ocean (Toulouse, France) biogeochemical and physical global ocean analysis and forecast system at 1/4 and 1/12 degree, respectively,  and to hindcast data for approx 3 years. \n<br><br> Biogeochemical parameters such as chlorophyll, nitrate, phosphate, silicate, dissolved oxygen, dissolved iron, primary production, phytoplankton, pH,  and surface partial pressure of carbon dioxide are available on a 3D grid with 1/4 degree resolution in latitude and longitude and a finite number of depth  levels (50 and 75 levels for forecast and hindcast, respectively). Any latitude, longitude and depth can be specified, and values are obtained for the nearest point in the dataset. If the point is over  land, the values will be null. Please note any responses over land will count toward the quota usage, we are working on implementing a method to return the nearest point  over ocean. \n<br><br>\nVisit the digital object identifier (DOI) link below for full details on those datasets and the underlying model. \u201cGenerated using E.U. Copernicus Marine Service Information; DOI <a href=\"https://doi.org/10.48670/moi-00019\">10.48670/moi-00019</a>  <a href=\"https://doi.org/10.48670/moi-00015\">10.48670/moi-00015</a>\n<br><br> Visit our <Button to='#' transparent><a href='https://developer.amentum.io'>Developer Portal</a></Button> to obtain an API key with a 14 day free trial.\n","name":"nemo","x-displayName":"NEMO Biogeochemistry and Physical Forecast and Hindcasts"},{"description":"Meteo-France's operational global ocean analysis and forecast system, with a 1/12 degree resolution, offers 10-day forecasts for global ocean sea surface waves, along with a 2 year rolling archive.  \n<br><br> It provides wave heights, directions, and frequencies. We provide web API access to the datasets for any latitude, longitude and depth specified, and values are obtained for the nearest point in the dataset. \n<br><br>\nVisit the digital object identifier (DOI) link below for full details on those datasets and the underlying model. \u201cGenerated using E.U. Copernicus Marine Service Information; DOI <a href=\"https://doi.org/10.48670/moi-00017\">10.48670/moi-00017</a>\n<br><br> Visit our <Button to='#' transparent><a href='https://developer.amentum.io'>Developer Portal</a></Button> to obtain an API key with a 14 day free trial.\n","name":"mfwam","x-displayName":"MFWAM Global Ocean Waves Analysis and Forecast"},{"description":"Calculate the speed of sound in seawater using Mackenzie's equation. The endpoint retrieves temperature and salinity from the Copernicus Marine NEMO physical dataset used by /nemo/phys for the requested date, latitude, longitude, and depth. Values are calculated at the nearest NEMO physical grid point using depth in meters.\n<br><br>\nVisit our <Button to='#' transparent><a href='https://developer.amentum.io'>Developer Portal</a></Button> to obtain an API key with a 14 day free trial.\n","name":"speed-sound","x-displayName":"Seawater Sound Speed"}]}
