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 |