The CO-OPS Derived Product API (DPAPI) can be used to retrieve
information about CO-OPS' derived products. The types of product
accessible via the API are listed in detail under the heading "
Products".
Version 1.1 - Extreme Water Levels Update
Version 0.1 - Initial Development Release
Version 0.1 is the draft development release of the CO-OPS Derived
Product API. As changes are made to the API and fields are added
or modified, the release notes contained within this section will
be updated to reflect the changes.
Version 0.1:
- Documentation created
- Product Types
- Top Ten Water Levels
- Extreme Water Levels
- Sea Level Trends
- High Tide Flooding Data
- Daily Flood Count
- Monthly Flood Count
- Seasonal Flood Count
- Annual Flood Count
- Met Year Flood Count
- Next Met Year Annual Outlook
- Projected Floods Per Year Per Scenario
- Decadal Projections
- Output formats
Top Ten Water Levels
- Input Parameters
- name: toptenwaterlevels
- station: 7-digit station ID (if omitted, all stations
are returned)
- units: Output units (english/metric, if omitted,
english units are used)
- datum: Datum reference
(STND/MHHW/MHW/MSL/MTL/MLW/MLLW/NAVD for Tidal stations and
IGLD/LWD for Great Lakes stations, not case-sensitive, if
omitted, MHHW/IGLD is used)
- Output
- Station ID
- Station Name
- Date
- Time
- Water Level Height
- Reference Datum
- Event Category (e.g. tropical, extratropical, etc).
- Event Name
- Data Source (e.g. observed, high water mark, etc)
Event Station Peak Water Levels
- Input Parameters
- name: peakwaterlevels
- event id: Numerical identifier corresponding to a peak
water level event (see Peak Water Level Events)
- units: Output units (english/metric, if omitted,
english units are used)
- datum: Datum reference
(STND/MHHW/MHW/MSL/MTL/MLW/MLLW/NAVD for Tidal stations and
IGLD/LWD for Great Lakes stations, not case-sensitive, if
omitted, MHHW/IGLD is used)
- Output
- Station ID
- Station Name
- Date
- Water Level Height
- Reference Datum
- Event Category (e.g. tropical, extratropical, etc).
- Event Name
- Data Source (e.g. observed, high water mark, etc)
Peak Water Level Events
- Input Parameters
- name: peakwaterlevels
- year: 4-digit year
- Output
- Event ID
- Start Date (estimated date when water level impacts
began)
- Name
- Event Type (e.g. Tropical, Extra Tropical, Other)
- Dissemination flag (Used for web products)
- Great Lake flag (Used for web products)
- Storm Track flag (Used for web products)
Extreme Water Levels
- Input Parameters
- name: extremewaterlevels
- station: 7-digit station ID (if omitted, all stations
are returned)
- units: Output units (english/metric; defaults to
english (feet))
- Output
- stationId
- stationName
- stationTitle
- state
- epoch
- epochMidyear
- latitude
- longitude
- annotation (notes about stations where applicable)
- tenYearEvents (events exceeding the 10% annual
exceedance probability levels based on the POR MSL trend)
- count
- highs
- type: GEV_HI (Highest Extremes)
- date
- status (YES means the event date is in CO-OPS’s
digital records, NO means the event date was sourced from
historical records or alternate sources)
- lows
- type: GEV_LO (Lowest Extremes)
- date
- status (YES means the event date is in CO-OPS’s
digital records, NO means the event date was sourced from
historical records or alternate sources)
- annuals: API URL for station detrended annual extremes
- monthlies: API URL for station monthly extremes
- exceedanceLevels: API URL for station annual
probability exceedance levels ranging from 99% to 1%
probability
- exceedanceLevelsByMonth: API URL for station monthly
seasonal probability exceedance levels ranging from 99% to 1%
probability
Extreme Water Levels - Annual
Detrended Extremes
- Input Parameters
- name: extremewaterlevels
- extremeType: annuals
- station: 7-digit station ID
- units: Output units (english/metric; defaults to
english (feet))
- levelType: Output annual extreme values (high/low;
defaults to high)
- Output
- stationId
- units
- datum
- notice (explains that the annual extreme values are
provided after the monthly extreme series has been detrended
and that values cannot be shifted to other datums as they
aren’t relative to a single datum level, but to a linear
trendline)
- extremes
Extreme Water Levels - Monthly
Extremes
- Input Parameters
- name: extremewaterlevels
- extremeType: monthlies
- station: 7-digit station ID
- units: Output units (english/metric; defaults to
english (feet))
- levelType: Output high or low monthly extreme values
(high/low; defaults to high)
- datum: Tidal datum reference for returned data
(MHHW/MHW/STND/MLW/MLLW/MSL; defaults are MHHW for high and
MLLW for low)
- Output
- stationId
- units
- datum
- extremes
Extreme Water Levels - Annual
Exceedance Levels
- Input Parameters
- name: extremewaterlevels
- station: 7-digit station ID
- details: exceedancelevels
- units: Output units (english/metric; defaults to
english (feet))
- levelType: Output high or low monthly extreme values
(high/low; defaults to high)
- Output
- station ID
- units
- datum
- Exceedance Level: Returns GEV_HI (highest extremes) or
GEV_LO (lowest extremes) based on levelType
- probability (the Annual Exceedance Probability (AEP),
this is the chance that water will reach or exceed this
specific level in any single year)
- returnPeriod (the average amount of time you would
expect to wait between events of this magnitude, the inverse
of the probability)
- level (the actual predicted maximum water level for
this probability)
- upper90CI (upper 90% confidence interval calculated
using profile likelihood for return periods >= 2 years and
using normal method for return periods < 2 years)
- lower90CI (lower 90% confidence interval calculated
using profile likelihood for return periods >= 2 years and
using normal method for return periods < 2 years)
Extreme Water Levels - Monthly
Exceedance Levels
- Input Parameters
- name: extremewaterlevels
- station: 7-digit station ID
- details: exceedancelevelsmonth
- units: Output units (english/metric; defaults to
english (feet))
- levelType: Output high or low monthly extreme values
(high/low; defaults to high)
- Output
- station ID
- units
- datum
- Exceedance Levels: Returns GEV_HI_[MON] (highest
extreme for every month of the year) or GEV_LO_[MON] (lowest
extreme for every month of the year) based on levelType
- probability (the Annual Exceedance Probability (AEP),this is the chance that water will reach or exceed this
specific level in any single year)
- returnPeriod (the average amount of time you would
expect to wait between events of this magnitude, the inverse
of the probability)
- level (the actual predicted maximum water level for
this probability)
- upper90CI (upper 90% confidence interval calculated
using profile likelihood for return periods >= 2 years and
using normal method for return periods < 2 years)
- lower90CI (lower 90% confidence interval calculated
using profile likelihood for return periods >= 2 years and
using normal method for return periods < 2 years)
Observed Sea Levels
- Input Parameters
- name: observedSL
- station: 7-digit station ID (if omitted, all stations
are returned)
- units: Output units (english/metric; defaults to
english (feet))
- trendType: Station filter by trend (omit to show all observedSL stations; specify NTDE for stations with an NTDE trend rate, or 30YEAR for stations with data on variation in 30-year trends)
- Output
- stationID
- metadata
- stationName
- state
- annotation (provides important additional information
for select stations including combined station details such as
station ID, start date, end date, and the adjustment value in
meters)
- trendUnits (for the trend rate, feet/decade if english
unit or mm/year if metric unit)
- seasonalUnits (for the seasonal cycle, feet if english
or meters if metric)
- changeUnits (for the change amount, feet if english or
meters if metric)
- latitude
- longitude
- trendType: Station filter by trend (omit to show all observedSL stations; specify NTDE for stations with an NTDE trend rate, or 30YEAR for stations with data on variation in 30-year trends)
- numberEvents (number of named events (earthquakes,
datum shifts, data quality issues in the station)
- events (includes event date and description)
- seaLvlTrend
- autoregressive (statistical coefficient: serial
correlation)
- autoregressiveError (statistical margin of error for
the autoregressive coefficient)
- trend (calculated trend rate using the arima (1,0,0)
model)
- trendError (margin of error for the trend)
- startDate
- endDate
- seasonalAverage (average of all monthly coefficients
from the arima (1,0,0) model)
- seaLvlChange
- changeNTDE (the difference between NTDE MSL and last 5
year average)
- changePOR (the difference between the first 5 year and
last 5 year average)
- changeNTDEoffset (an offset applied to stations on a
modified tidal datum offset to center the data on the NTDE)
- ntdeStartMidpoint
- ntdeEndMidpoint
- porStartMidpoint
- porEndMidpoint
- monthlyMeansUrl (link to the monthly means and trend
rate information for plotting)
- seasonalCycleMonth (the average seasonal cycle
calculated by the ARIMA(1,0,0) model, the seasonalAverage is
subtracted from each monthly coefficient to center the cycle
around zero, showing each month's relative deviation from the
mean)
- Month
- seasonalVar (the variation of the month from the mean)
- seasonalError (margin of error of the variation)
Observed Sea Levels - Monthly Means
- Input Parameters
- name: observedSL
- details: monthlymeans
- station: 7-digit station ID (if omitted, all stations
are returned)
- units: Output units (english/metric; defaults to
english (feet))
- Output
- Info (The values are in feet relative to the MSL.
Values are the Year, Month, Relative Sea Level, Relative Sea
Level minus Average Seasonal Cycle, Trend Line, Upper 95%
Confidence Interval, and Lower 95% Confidence Interval. The
station's monthly MSL data is provided for the period of record
and the trend information is available starting in July 1992.)
- stationID
- stationName
- Datum (only MSL)
- trendType (only NTDE)
- units
- data
- year
- month
- meanDate (monthly data is centered on the 15th of
every month)
- mslDeseasonalized (msl data with seasonal cycle
removed)
- msl (observed monthly mean MSL value)
- trendLine (value and location of trendline at specific
date)
- upperConfidence (upper 95% confidence interval at
specific date)
- lowerConfidence (lower 95% confidence interval at
specific date)
Regional Frequency Analysis
(RFA) Extreme Water Levels (EWL)
RFA-based EWL probabilities and their 95% confidence
intervals are from the Global and Regional Sea Level Rise
Scenarios for the United States: Updated Mean Projections and
Extreme Water Level Probabilities Along U.S. Coastlines (2022
Interagency Task Force (ITF)) and Downscaling gridded extreme
water level estimates at short term tide gauge locations (2025)
reports.
- Input Parameters
- station: 7-digit NOS station ID (if omitted, all
stations are returned)
- units: Output units (english/metric; if omitted,
english is used)
- datum: Tidal datum reference for returned data (STND,
MLLW, MHHW, MSL, MLW, MHW; default is MHHW)
- long_term: a parameter that is set to true/false and
returns all short-term or long-term stations
- Output Parameters
- stationId: NOS station 7-digit ID
- name: Station Name
- lat: Station Latitude
- lon: station Longitude
- tidalEpoch: Tidal datum epoch used for analysis
- gridNum: Index of 1° EWL grid cell used for
downscaling
- gridLat: Latitude of EWL grid cell center
- gridLong: Longitude of EWL grid cell center
- region: Geographic region from the ITF Report
- localUIndex: Local U-index (unit: meters/feet)
- localUTrend: Local linear sea level trend used for
data shifting (unit: mm/yr or in/yr)
- startDate: Start date of analysis period
- endDate: End date of analysis period
- validDays: Count of days with valid daily maximums
- totalDays: Total days in the analysis period
- percentValidDays: Percentage of valid days
- long_term_flag: Indicates if station is long-term
- short_term_flag: Indicates if station is short-term
- probabilitiesUnit: Unit for return level and
confidence interval (meters/feet)
- ewlProbabilities: return period (r1), the return level
(value), the upper (ci_high) and lower (ci_low) bound of the
90% confidence interval
Sea Level Trends
- Input Parameters
- station: 7-digit US station ID or Global station ID
with a "-" as the fourth character (if omitted, all stations
are returned)
- affil: Station affiliation, is either "Global" or "US"
(if omitted, all station are returned)
- Output
- Station ID
- Station Name
- Affiliation
- Latitude
- Longitude
- Trend
- Trend Error
- Units
- Start Date
- End Date
Sea Level Rise Projections
- Input Parameters
- station: 7-digit US station ID or Global station ID
- affil: Station affiliation, is either "Global" or "US"
- projection_year: Default is all years
- coastal_flag: default is 1
- station_or_grid: Valid inputs are 'station', 'grid',
'all'. Default is 'all'
- report_year: Default is latest report year
- units: Valid inputs are 'english' or 'metric'. Default
is metric.
- scenario: Valid inputs are 'all', 'low',
'intermediate-low', 'intermediate', 'intermediate-high',
'high', or 'extreme'. Default is 'all'.
- format: Valid inputs are 'xml' or 'json'. Default is
'json'
- page: Default is '1'
- lat
- lon
- min_lat: Minimum Latitude
- max_lat: Maximum Latitude
- min_lon: Minumum Longitude
- max_lon: Maximum Longitude
- Output
- Station Id
- Station Name
- Latitude
- Longitude
- Units
- PSMSL ID
- Scenario
- Report Year
- Projection Year
- Coastal Flag
- Background RSL Per Year
- Projection RSL
- Projection CI Low
- Projection CI High
Sea Level Rise
Projection Offsets
- Input Parameters
- station: 7-digit US station ID or Global station ID
- affil: Station affiliation, is either "Global" or "US"
- report_year: Default is latest report year
- units: Valid inputs are 'english' or 'metric'. Default
is metric.
- format: Valid inputs are 'xml' or 'json'. Default is
'json'
- Output
- Station Id
- Latitude
- Longitude
- Units
- Site Name
- PSMSL ID
- Report Year
- Offset Name
- Offset
High Tide Flooding - Daily Flood Count
- Input Parameters
- station: 7-digit station ID, required
- start_date: start date in format YYYYMMDD, required
- end_date: end date in format YYYYMMDD, required
- units: Output units (english/metric, if omitted,
english units are used)
- datum: Datum reference, (valid options include: "STND",
"MLLW", "MHHW", "GT", "MSL", "MLW", "MHW", not case-sensitive.,
if omitted, STND is used)
- Output
- Station ID
- Station Name
- Latitude
- Longitude
- Units
- Day
- Daily Maximum Water Level
- Time of Daily Maximum Water Level
- The flag that the water level exceeds the major flood
threshold
- The flag that the water level exceeds the moderate
flood threshold
- The flag that the water level exceeds the minor flood
threshold
- The flag that indicates the data is missing
High Tide Flooding - Monthly Flood Count
- Input Parameters
- station: 7-digit station ID, required
- start_date: start date in format YYYYMMDD, optional
- end_date: end date in format YYYYMMDD, optional
- year: 4-digit calendar year number, optional
- range: year range, (if omitted, 0 is used)
- month: month number from 1-12, optional
- Output
- Station ID
- Station Name
- Latitude
- Longitude
- Year
- Month
- The number of flood days that exceed the major flood
threshold each month
- The number of flood days that exceed the moderate flood
threshold each month
- The number of flood days that exceed the minor flood
threshold each month
- The number of days that the flood data is missing each
month
High Tide Flooding - Seasonal Flood Count
- Input Parameters
- station: 7-digit station ID, required
- year: 4-digit calendar year number (if omitted, all
years are returned)
- range: year range (if omitted, 0 is used)
- season: season number 1-Winter, 2-Spring, 3-Summer,
4-Fall, (if omitted, all seasons are returned)
- season_months: season months DJF-Winter, MAM-Spring,
JJA-Summer, SON-Fall, (if omitted, all seasons are returned)
- Output
- Station ID
- Station Name
- Latitude
- Longitude
- Year
- Season ID
- Season Name
- Season Months
- The number of flood days that exceed the major flood
threshold each season
- The number of flood days that exceed the moderate flood
threshold each season
- The number of flood days that exceed the minor flood
threshold each season
- The number of days that the flood data is missing each
season
High Tide Flooding - Annual Flood Count
- Input Parameters
- station: 7-digit station ID (if omitted, all stations
are returned)
- year: 4-digit calendar year number (if omitted, all
years are returned)
- range: year range (if omitted, 0 is used)
- Output
- Station ID
- Station Name
- Latitude
- Longitude
- Year
- The number of flood days that exceed the major flood
threshold every annual year
- The number of flood days that exceed the moderate flood
threshold every annual year
- The number of flood days that exceed the minor flood
threshold every annual year
- The number of days that the flood data is missing every
annual year
High Tide Flooding - Met Year Flood Count
- Input Parameters
- station: 7-digit station ID (if omitted, all stations
are returned)
- met_year: 4-digit meteorological year number (if
omitted, all years are returned)
- range: year range (if omitted, 0 is used)
- Output
- Station ID
- Station Name
- Latitude
- Longitude
- The Meteorological Year
- The number of flood days that exceed the major flood
threshold every annual year
- The number of flood days that exceed the moderate flood
threshold every annual year
- The number of flood days that exceed the minor flood
threshold every annual year
- The number of days that the flood data is missing every
annual year
High Tide Flooding - Next Met Year Annual
Outlook
- Input Parameters
- station: 7-digit station ID (if omitted, all stations
are returned)
- met_year: 4-digit meteorological year number (if
omitted, all years are returned)
- range: year range (if omitted, 0 is used)
- Output
- Station ID
- Station Name
- Latitude
- Longitude
- Met Year
- The number of projected minor flood days for the next
meteorological year. The projection +1 std.
- The number of projected minor flood days for the next
meteorological year. The projection -1 std.
- The number of flood days that exceed the minor flood
threshold every annual year
- The date when the next met-year annual outlook was
calculated.
- The method used to calculate the projection for the
next met-year annual outlook.
High Tide Flooding - Projected Floods Per Year
Per Scenario
NOAA's Center for Operational
Oceanographic Products & Services will no longer be disseminating
this data set through the Derived Product API web service. For
more information, please contact Tide.Predictions@noaa.gov
High Tide Flooding - Decadal Projections
Projected Minor/disruptive, Moderate/typically damaging,
and Major/often destructive High Tide Flooding days by sea level
rise scenario per decade.
- Input Parameters
- station: 7-digit station ID (if omitted, all stations
are returned)
- decade: 4-digit decade number ending with 0 (if
omitted, all decades are returned)
- range: Decade range (if omitted, 0 is used; e.g.,
decade=2050&range=5
returns data for six decades: 2050â2090)
- flood_threshold: NOS threshold used for estimating
projected high tide flooding days (minor, moderate, major; if
omitted, all thresholds are returned)
- Output Parameters
- stnId: 7-digit station ID
- stnName: Name of the station
- lat: Latitude in decimal format
- lon: Longitude in decimal format
- DecadalProjection: Decadal HTF projection above the
'minor', 'moderate' or 'major' NOS thresholds
- decade: Reference decade
- Source: Reference used for computation of the
projections
- low: Projected flooding days under low sea level
scenario (days)
- intLow: Projected flooding days under intermediate-low
sea level scenario (days)
- intermediate: Projected flooding days under
intermediate sea level scenario (days)
- intHigh: Projected flooding days under
intermediate-high sea level scenario (days)
- high: Projected flooding days under high sea level
scenario (days)
High Tide Flooding - Record Days and Typical HTF
Days in 2000
- Input Parameters
- station: 7-digit station ID (if omitted, all stations
are returned)
- Output
- Station ID
- Station Name
- Report Year
- Record Year
- Record High Tide Flooding(HTF) Day
- Observed Period
- Typical HTF Days in 2000
- Tied (1' if record year is tied for record HTF day, '0'
if no tie)
High Tide Flooding - Likely Decadal Scenarios
Projected Minor/disruptive, Moderate/typically damaging,
and Major/often destructive High Tide Flooding days by Regional
Likely sea level rise scenario for 2050.
- Input Parameters
- station: 7-digit station ID (if omitted, all stations
are returned)
- decade: 4-digit decade number ending with 0 (if
omitted, all decades are returned)
- flood_threshold: NOS threshold used for estimating
projected high tide flooding days (minor, moderate, major; if
omitted, all thresholds are returned)
- Output Parameters
- stnId: 7-digit station ID
- stnName: The name of the station
- lat: Latitude in decimal format
- lon: Longitude in decimal format
- LikelyDecadalScenarios: Decadal HTF projection above
the 'minor', 'moderate', or 'major' NOS thresholds
- year: Reference decade (2050)
- Source: Reference used for computation of the
projections
- lower_bound: Lower bound of most likely high tide
flood days
- upper_bound: Upper bound of most likely high tide
flood days
- lower_scenario: The most likely lower bound scenario
- upper_scenario: The most likely upper bound scenario
High Tide Flooding - Daily Likelihoods
- Input Parameters
- station: 7-digit station ID (required for specific
station)
- start_date: start date in format YYYYMMDD (required
with station Id)
- end_date: end date in format YYYYMMDD(required with
station Id)
- date: specific date in format YYYYMMDD(required for
specific date)
- station_flood: flood possibility for the specific date.
'any', 'true', 'false' (if omitted, all possibilities return).
- dissemination: dissemination value of the station. '0',
'1', 'all' (if omitted, all with dissemination equal to 1
return).
- range: day range (if omitted, 0 is used)
- threshold: threshold that flood likelihoods are
relative to including NOS minor (default), NWS minor (where
available), or 0.5 ft increments above MHHW. Options are:
nos_minor, nws_minor, 0.5, 1.0, 1.5, 2.0, 2.5
- units: Output units (english/metric, if omitted,
english units are used)
- datum: Datum reference
(STND/MHHW/MHW/MSL/MTL/MLW/MLLW/NAVD, not case-sensitive, if
omitted, MHHW is used)
- year: when specified with month, returns output for
each model run
- month: when specified with year, returns output for
each model run
- run_id: when specified with month and year, returns
output for the specific model run
- Output
- Count
- Threshold type (threshold that flood likelihoods are
relative to including NOS minor (default), NWS minor (where
available), or 0.5 ft increments above MHHW)
- Station ID
- Station Name
- Latitude
- Longitude
- Region
- Date (date likelihood produced for)
- Flood (likelihood score indicates potential for
flooding: true / false)
- Likelihood (percent)
- Flood threshold (in specified units, default = feet)
- Distance to threshold (in specified units, default =
feet)
- Updated date (Date the likelihoods were last updated by
the model)
- Dissemination (Returns only when dissemination is 'all'
: 0/ 1)
- runId (unique identifier of the model run)
High Tide Flooding - Daily Likelihoods Text
- Input Parameters
- region: Region reference (Northeast, Mid-Atlantic, Gulf
Coast, West Coast, Pacific Islands, Alaska, Southeast and
Caribbean Islands)
- year: 4-digit calendar year number (if omitted, all
years are returned)
- month: month in format MM (if omitted, all months are
returned)
- Output
- Region
- Year
- Month
- Reason
- Impact
High Tide Flooding - Monthly Maximum Likelihoods
- Input Parameters
- station: 7-digit station ID (required for specific
station)
- start_date: start date in format YYYYMMDD or YYYYMM
- end_date: end date in format YYYYMMDD or YYYYMM
- threshold: threshold that flood likelihoods are
relative to including NOS minor (default), NWS minor (where
available), or 0.5 ft increments above MHHW. Options are:
nos_minor, nws_minor, 0.5, 1.0, 1.5, 2.0, 2.5
- dissemination: dissemination value of the station. '0',
'1', 'all' (if omitted, all with dissemination equal to 1
return).
- units: Output units (english/metric, if omitted,
english units are used)
- datum: Datum reference
(STND/MHHW/MHW/MSL/MTL/MLW/MLLW/NAVD, not case-sensitive, if
omitted, MHHW is used)
- Output
- Count
- Threshold type (threshold that flood likelihoods are
relative to including NOS minor (default), NWS minor (where
available), or 0.5 ft increments above MHHW)
- Station ID
- Station Name
- Latitude
- Longitude
- Region
- Month
- Year
- Maximum date (date of the maximum likelihood for the
month)
- Flood (likelihood score indicates potential for
flooding: true / false)
- Maximum likelihood (percent)
- Flood threshold (in specified units, default = feet)
- Distance to threshold (in specified units, default =
feet)
- Updated date (Date the likelihoods were last updated by
the model)
- Dissemination (Returns only when dissemination is 'all'
: 0/ 1)
Bench Mark Data
- Input Parameters
- VM: 4-digit number
- PID(mark identifier): two letters plus 4 digits
(example HU0108)
- date:format YYYY-MM-DD
- Output
- Designation
- VM
- Latitude
- Longitude
- Description
- Published
- Stamping
- Alias
- IdbPid
- Station ID
- Verified
- Display
- State Code
- Datums
Current Predictions Annual Report
- Input Parameters
- station: 7-digit station ID (required for specific
station)
- year: format YYYY
- format: pdf, csv, txt, xml
- time-zone: LST_LDT, LST, GMT
- units: 1 (english), 0 (metric)
- date-timeUnits: am/pm, 24hr
- Output
- Current Predictions Report
PORTS Screen
- Input Parameters
- portsId: PORTS ID (required for specific PORTS)
- Output