Skip to main content

Advice and Scenarios Database (ASD)

ICES advice records and their catch scenario tables and notes, from the ICES Advice and Scenarios Database.

Base url: https://asd.ices.dk/API · Documentation · Website

Checked 21 November 2026, 13:18 UTC. Responses are compared with the baseline recorded on 2026-10-20.

Used by

Directly: icesASD

Through a dependency: icesAdviceSheet

Notes

Topic Observation Affects
Operations that change data createAndAdviceFromSAGRecord and pushCatchOptionTableToAdvice change data but are GET operations, so they can be triggered by opening a link (or by a link checker or browser prefetch). They are not called by this check. Nothing in icesASD at present.
Uploading catch scenarios upload_catch_scenario() in icesASD posts to https://data.ices.dk/vms/webapi/ScreenVMSFile, the VMS screening service, not an ASD endpoint. That address no longer exists (404). upload_catch_scenario() does not work.
Content types DownloadCatchScenariosCSV and DownloadCatchScenariosXML are sent as text/plain, not text/csv and application/xml. The XML refers to a stylesheet, CatchOptionsTable.xsl. Clients have to know the format; icesASD does not use these endpoints.
Unknown keys An unknown advice key or stock code returns HTTP 200 with [], not 404. getCatchScenariosTable() and getAdviceViewRecord() return empty results rather than an error for a wrong key or stock code.
Field names Field names are camelCase, some with abbreviated prefixes (cS_Label, aR_ID, aK_ID). Parameter names are not case sensitive: the documentation has StockCode and assessmentkey, icesASD sends stockcode and assessmentKey. Code that uses field names; the change check reports any change of case.
Downloads api/Download (POST, a JSON list of advice keys) returns a zip file with names that contain the date and time, e.g. AdviceDownload_21_10_2026_00_46.zip, holding the catch scenarios as CSV and a disclaimer PDF. Nothing at present.

Endpoints checked

Endpoint Status HTTP Time (s) Size (kB) Records Fields
getAdviceViewRecord, by year No changes 200 1.31 306.9 207 41
getAdviceViewRecord, by stock No changes 200 0.13 1.5 1 41
getAdviceViewRecord, by assessment No changes 200 0.13 1.5 1 41
getCatchScenariosTable No changes 200 0.13 27.7 112 14
getCatchScenariosNotes No changes 200 0.12 1.6 8 6
DownloadCatchScenariosCSV No changes 200 0.31 2.4 21 16
DownloadCatchScenariosXML No changes 200 0.14 16.6 146 23
api/Download No changes 200 0.58 76.4 22 48

Changes since the baseline

No changes: every endpoint returns the same structure as the baseline.

Documented operations

The documentation (ICES.AdviceView.API v1) lists 8 operations, of which 6 are checked here. No changes to the operations or their parameters since the baseline.

Operation Parameters Checked
GET /createAndAdviceFromSAGRecord/{assessmentKey} assessmentKey (path, integer, required)
POST /api/Download api/Download
GET /DownloadCatchScenariosCSV/{ID} ID (path, integer, required) DownloadCatchScenariosCSV
GET /DownloadCatchScenariosXML/{ID} ID (path, integer, required) DownloadCatchScenariosXML
GET /getAdviceViewRecord year (query, integer)
StockCode (query, string)
assessmentkey (query, integer)
getAdviceViewRecord, by year, getAdviceViewRecord, by stock, getAdviceViewRecord, by assessment
GET /getCatchScenariosTable/{id} id (path, integer, required) getCatchScenariosTable
GET /getCatchScenariosNotes/{id} id (path, integer, required) getCatchScenariosNotes
GET /pushCatchOptionTableToAdvice/{adviceKey}/{sessionID} sessionID (path, integer, required)
adviceKey (path, integer, required)

R functions

The packages are designed with one R function for each endpoint, and further functions that combine endpoints into a dataset. Functions are found by reading the code of icesASD. 4 of the 6 operations that read data have an R function; a function name is suggested for the others.

Operations and R functions

Operation R function Also used in
GET /createAndAdviceFromSAGRecord/{assessmentKey} none: uploads or changes data
POST /api/Download adviceDownload()
GET /DownloadCatchScenariosCSV/{ID} missing: suggest getDownloadCatchScenariosCSV()
GET /DownloadCatchScenariosXML/{ID} missing: suggest getDownloadCatchScenariosXML()
GET /getAdviceViewRecord getAdviceViewRecord() getASD()
GET /getCatchScenariosTable/{id} getCatchScenariosTable() get_catch_scenario_table(), getASD()
GET /getCatchScenariosNotes/{id} getCatchScenariosNotes() getASD()
GET /pushCatchOptionTableToAdvice/{adviceKey}/{sessionID} none: uploads or changes data

Combined functions

Function Builds on Operations
getASD() getAdviceViewRecord(), getCatchScenariosNotes(), getCatchScenariosTable() /getAdviceViewRecord, /getCatchScenariosNotes/{id}, /getCatchScenariosTable/{id}
get_catch_scenario_table() getCatchScenariosTable() /getCatchScenariosTable/{id}

Endpoint details

getAdviceViewRecord, by year

https://asd.ices.dk/API/getAdviceViewRecord?year=2024

Called by: getAdviceViewRecord(), getASD()

Operation: GET /getAdviceViewRecord

HTTP 200 · application/json · 1.31 s · 207 records

Field Type
(root) array
[] object
[].adviceApplicableFrom string (date-time)
[].adviceApplicableUntil string (date-time)
[].adviceCategory string
[].adviceComponent string | string (number)
[].adviceDOI string
[].adviceKey number
[].adviceLink string
[].adviceReleasedDate string (date-time)
[].adviceRequester null | string
[].adviceSentence string
[].adviceStatus string
[].adviceType string
[].adviceValue string | string (number)
[].adviceValueLowerRange null | number
[].adviceValueUnit string
[].adviceValueUpperRange null | number
[].adviceViewPublished boolean
[].approvedASD null
[].approvedSAG boolean | null
[].assessmentComponent null | string | string (empty)
[].assessmentKey number
[].assessmentYear number
[].createDate string (date-time)
[].linkToAdviceView string
[].linkToEvaluation null | string
[].managementAlignment string
[].managementPlanOwnership null | string
[].mpwebLink null | string
[].stockCategory string (number)
[].stockCode string
[].stockComponent string
[].taflink null | string
[].tblCodeID_AdviceCategory number
[].tblCodeID_AdviceType number
[].tblCodeID_ManagementAlignment number
[].tblCodeID_StockCode number
[].wantedCatch null | number
[].wantedCatchLowerRange null
[].wantedCatchUpperRange null

getAdviceViewRecord, by stock

https://asd.ices.dk/API/getAdviceViewRecord?StockCode=ple.27.420&year=2024

Called by: getAdviceViewRecord(), getASD()

Operation: GET /getAdviceViewRecord

HTTP 200 · application/json · 0.13 s · 1 records

Field Type
(root) array
[] object
[].adviceApplicableFrom string (date-time)
[].adviceApplicableUntil string (date-time)
[].adviceCategory string
[].adviceComponent string
[].adviceDOI string
[].adviceKey number
[].adviceLink string
[].adviceReleasedDate string (date-time)
[].adviceRequester string
[].adviceSentence string
[].adviceStatus string
[].adviceType string
[].adviceValue string (number)
[].adviceValueLowerRange null
[].adviceValueUnit string
[].adviceValueUpperRange null
[].adviceViewPublished boolean
[].approvedASD null
[].approvedSAG null
[].assessmentComponent null
[].assessmentKey number
[].assessmentYear number
[].createDate string (date-time)
[].linkToAdviceView string
[].linkToEvaluation null
[].managementAlignment string
[].managementPlanOwnership string
[].mpwebLink string
[].stockCategory string (number)
[].stockCode string
[].stockComponent string
[].taflink string
[].tblCodeID_AdviceCategory number
[].tblCodeID_AdviceType number
[].tblCodeID_ManagementAlignment number
[].tblCodeID_StockCode number
[].wantedCatch null
[].wantedCatchLowerRange null
[].wantedCatchUpperRange null

getAdviceViewRecord, by assessment

https://asd.ices.dk/API/getAdviceViewRecord?assessmentkey=18688

Called by: getAdviceViewRecord(), getASD()

Operation: GET /getAdviceViewRecord

HTTP 200 · application/json · 0.13 s · 1 records

Field Type
(root) array
[] object
[].adviceApplicableFrom string (date-time)
[].adviceApplicableUntil string (date-time)
[].adviceCategory string
[].adviceComponent string
[].adviceDOI string
[].adviceKey number
[].adviceLink string
[].adviceReleasedDate string (date-time)
[].adviceRequester string
[].adviceSentence string
[].adviceStatus string
[].adviceType string
[].adviceValue string (number)
[].adviceValueLowerRange null
[].adviceValueUnit string
[].adviceValueUpperRange null
[].adviceViewPublished boolean
[].approvedASD null
[].approvedSAG null
[].assessmentComponent null
[].assessmentKey number
[].assessmentYear number
[].createDate string (date-time)
[].linkToAdviceView string
[].linkToEvaluation null
[].managementAlignment string
[].managementPlanOwnership string
[].mpwebLink string
[].stockCategory string (number)
[].stockCode string
[].stockComponent string
[].taflink string
[].tblCodeID_AdviceCategory number
[].tblCodeID_AdviceType number
[].tblCodeID_ManagementAlignment number
[].tblCodeID_StockCode number
[].wantedCatch null
[].wantedCatchLowerRange null
[].wantedCatchUpperRange null

getCatchScenariosTable

https://asd.ices.dk/API/getCatchScenariosTable/3577

Called by: getCatchScenariosTable(), get_catch_scenario_table(), getASD()

Operation: GET /getCatchScenariosTable/{id}

HTTP 200 · application/json · 0.13 s · 112 records

Field Type
(root) array
[] object
[].adviceKey number
[].aK_ID number
[].aK_Label string
[].aR_ID number
[].assessmentKey number
[].cS_Basis string
[].cS_Label string
[].cS_Purpose string
[].stockDataType string
[].unit string
[].value number
[].yearLabel string (number)

getCatchScenariosNotes

https://asd.ices.dk/API/getCatchScenariosNotes/3577

Called by: getCatchScenariosNotes(), getASD()

Operation: GET /getCatchScenariosNotes/{id}

HTTP 200 · application/json · 0.12 s · 8 records

Field Type
(root) array
[] object
[].adviceKey number
[].catchOptionsTableKey number
[].notes string
[].symbol string

DownloadCatchScenariosCSV

https://asd.ices.dk/API/DownloadCatchScenariosCSV/3577

Operation: GET /DownloadCatchScenariosCSV/{ID}

HTTP 200 · text/plain · 0.31 s · 21 records

Field Type
(root) csv
response.csv/% advice change^ string | string (empty) | string (number)
response.csv/% change in projected catches^^^ Subarea 4 and Subdivision 20 string | string (empty) | string (number)
response.csv/% SSB change *** string | string (empty) | string (number)
response.csv/% TAC change# Subarea 4 and Subdivision 20 string | string (empty) | string (number)
response.csv/Basis string | string (empty)
response.csv/Fprojected discards(ages 2-3) string | string (empty) | string (number)
response.csv/Fprojected landings(ages 2-6) string | string (empty) | string (number)
response.csv/Ftotal(ages 2-6)** string | string (empty) | string (number)
response.csv/Projected discards* string | string (empty) | string (number)
response.csv/Projected discards* Subarea 4 and Subdivision 20 string | string (empty) | string (number)
response.csv/Projected landing Subarea 4 and Subdivision 20 string | string (empty) | string (number)
response.csv/Projected landings string | string (empty) | string (number)
response.csv/SSB string | string (empty) | string (number)
response.csv/Total catch string | string (empty) | string (number)
response.csv/Total catch^^ Subarea 4 and Subdivision 20 string | string (empty) | string (number)

DownloadCatchScenariosXML

https://asd.ices.dk/API/DownloadCatchScenariosXML/3577

Operation: GET /DownloadCatchScenariosXML/{ID}

HTTP 200 · text/plain · 0.14 s · 146 records

Field Type
Assessment element
Assessment/@noNamespaceSchemaLocation string
Assessment/AssessmentYear string (number)
Assessment/Catch_Scenario_Notes_Notes element
Assessment/Catch_Scenario_Notes_Notes/Notes string
Assessment/Catch_Scenario_Notes_Notes/Symbol string
Assessment/contact string
Assessment/Purpose string
Assessment/Scenarios_Columns element
Assessment/Scenarios_Columns/AK_ID string (number)
Assessment/Scenarios_Columns/AK_Label string
Assessment/Scenarios_Columns/Unit string
Assessment/Scenarios_Columns/YearLabel string (number)
Assessment/Scenarios_Rows element
Assessment/Scenarios_Rows/AR_ID string (number)
Assessment/Scenarios_Rows/CS_Basis string
Assessment/Scenarios_Rows/CS_Label string
Assessment/Scenarios_Rows/CS_Purpose string
Assessment/Scenarios_Values element
Assessment/Scenarios_Values/AK_ID string (number)
Assessment/Scenarios_Values/AR_ID string (number)
Assessment/Scenarios_Values/Value string (number)
Assessment/stockCode string

api/Download

https://asd.ices.dk/API/api/Download

Called by: adviceDownload()

Operation: POST /api/Download

HTTP 200 · application/zip · 0.58 s · 22 records

Field Type
(root) zip
CatchScenarios_AdviceKey_#_#_#_#_#_#.csv file
CatchScenarios_AdviceKey_#_#_#_#_#_#.csv/% advice change^ string | string (empty) | string (number)
CatchScenarios_AdviceKey_#_#_#_#_#_#.csv/% change in projected catches^^^ Subarea 4 and Subdivision 20 string | string (empty) | string (number)
CatchScenarios_AdviceKey_#_#_#_#_#_#.csv/% SSB change *** string | string (empty) | string (number)
CatchScenarios_AdviceKey_#_#_#_#_#_#.csv/% TAC change# Subarea 4 and Subdivision 20 string | string (empty) | string (number)
CatchScenarios_AdviceKey_#_#_#_#_#_#.csv/Basis string | string (empty)
CatchScenarios_AdviceKey_#_#_#_#_#_#.csv/Fprojected discards(ages 2-3) string | string (empty) | string (number)
CatchScenarios_AdviceKey_#_#_#_#_#_#.csv/Fprojected landings(ages 2-6) string | string (empty) | string (number)
CatchScenarios_AdviceKey_#_#_#_#_#_#.csv/Ftotal(ages 2-6)** string | string (empty) | string (number)
CatchScenarios_AdviceKey_#_#_#_#_#_#.csv/Projected discards* string | string (empty) | string (number)
CatchScenarios_AdviceKey_#_#_#_#_#_#.csv/Projected discards* Subarea 4 and Subdivision 20 string | string (empty) | string (number)
CatchScenarios_AdviceKey_#_#_#_#_#_#.csv/Projected landing Subarea 4 and Subdivision 20 string | string (empty) | string (number)
CatchScenarios_AdviceKey_#_#_#_#_#_#.csv/Projected landings string | string (empty) | string (number)
CatchScenarios_AdviceKey_#_#_#_#_#_#.csv/SSB string | string (empty) | string (number)
CatchScenarios_AdviceKey_#_#_#_#_#_#.csv/Total catch string | string (empty) | string (number)
CatchScenarios_AdviceKey_#_#_#_#_#_#.csv/Total catch^^ Subarea 4 and Subdivision 20 string | string (empty) | string (number)
Data_#_#_#_#_#.csv file
Data_#_#_#_#_#.csv/AdviceApplicableFrom string
Data_#_#_#_#_#.csv/AdviceApplicableUntil string
Data_#_#_#_#_#.csv/AdviceBasis string
Data_#_#_#_#_#.csv/AdviceComponent string
Data_#_#_#_#_#.csv/AdviceDOI string
Data_#_#_#_#_#.csv/AdviceKey string (number)
Data_#_#_#_#_#.csv/AdviceReleasedDate string
Data_#_#_#_#_#.csv/AdviceRequester string
Data_#_#_#_#_#.csv/AdviceSentence string
Data_#_#_#_#_#.csv/AdviceStatus string
Data_#_#_#_#_#.csv/AdviceType string
Data_#_#_#_#_#.csv/AdviceValue string (number)
Data_#_#_#_#_#.csv/AdviceValueLowerRange string (empty)
Data_#_#_#_#_#.csv/AdviceValueUnit string
Data_#_#_#_#_#.csv/AdviceValueUpperRange string (empty)
Data_#_#_#_#_#.csv/AdviceViewlink string
Data_#_#_#_#_#.csv/AssessmentComponent string (empty)
Data_#_#_#_#_#.csv/AssessmentKey string (number)
Data_#_#_#_#_#.csv/AssessmentYear string (number)
Data_#_#_#_#_#.csv/ManagementPlanlink string
Data_#_#_#_#_#.csv/ManagementPlanOwnership string
Data_#_#_#_#_#.csv/MPevaluationLink string (empty)
Data_#_#_#_#_#.csv/SIDlink string (empty)
Data_#_#_#_#_#.csv/StockCategory string (number)
Data_#_#_#_#_#.csv/StockCode string
Data_#_#_#_#_#.csv/TAFlink string
Data_#_#_#_#_#.csv/WantedCatch string (empty)
Data_#_#_#_#_#.csv/WantedCatchLowerRange string (empty)
Data_#_#_#_#_#.csv/WantedCatchUpperRange string (empty)
Disclaimer.pdf file