Provides information on Stocks with no nested Assessment Units, Unascertained, and all Assessment Units (whether they are top nodes or children nodes) that are not Salmon related. Draft information is not returned by this endpoint.
The response is a JSON array with a single JSON object, summarising information about the single Fishery Profile tree requested.
As the number of data points can be quite large, the response doesn’t contain any quantitative data associated with the Fishery Profile tree, but this can be fetched using the DATA endpoint.
| Element | Description (Root) | Description (Child) |
|---|---|---|
| id | The internal FishSource identifier for the Stock, AssessmentUnit or Unascertained node at the root of the Fishery Profile Tree | The internal FishSource identifier for the AssessmentUnit child node in the Fishery Profile Tree |
| name | The name of the root node prefixed by the Species FAO name or first common name. This is the same as the name shown on the FishSource website. | The name of the child node prefixed by the Species FAO name or first common name. |
| grsf_uuid | The UUID of the GRSF record associated with this root node if approved | The UUID of the GRSF record associated with this child node if approved |
| type | Indicates whether the root of the Fishery Profile Tree is a Stock, AssessmentUnit or Unascertained | Indicates the Fishery Profile Tree type. For child node, the type will always shown as AssessmentUnit since Stock and Unascertained are only available for the root node. |
| node_type | Indicates the type of the Fishery Profile node level. Root type indicates that the Fishery Profile is on the top level of the Fishery Profile Tree structure. | Indicates the type of the Fishery Profile node level. Child type indicates that the Fishery Profile is on the second tier of the Fishery Profile Tree structure. |
| grsf_type | Indicates the Fishery Profile type based on the GRSF classification. There are 2 types of GRSF classification: 1. Assessment Unit Fishery Profile of type: Stock with no nested Assessment Unit OR Fishery Profile of type: AssessmentUnit will be classified in this grsf_type.2. Marine Resource Fishery Profile of type: Unascertained will be classified in this grsf_type. |
Indicates the Fishery Profile type based on the GRSF classification. There are 2 types of GRSF classification: 1. Assessment Unit Fishery Profile of type: Stock with no nested Assessment Unit OR Fishery Profile of type: AssessmentUnit will be classified in this grsf_type.2. Marine Resource Fishery Profile of type: Unascertained will be classified in this grsf_type. |
| species | A JSON hash documenting the fao_name, order, family, genus, specific_descriptor and code_3a of the Species associated with the Fishery Profile Tree. | A JSON hash documenting the fao_name, order, family, genus, specific_descriptor and code_3a of the Species associated with the Fishery Profile Tree. |
| assessment_areas | An array of Assessment Areas associated with this root node. Each element specifies the name, type and code of the Assessment Area. | An array of Assessment Areas associated with this child node. Each element specifies the id, name, type and code of the Assessment Area. |
| exploiting_fisheries | An array of internal FishSource identifiers for all Fisheries contained within the Fishery Profile tree | An array of internal FishSource identifiers for all Fisheries nested within this branch. |
| management_units | An array of Management Units associated within this stock. Each Management Unit has three elements: Id: our internal DB identifier for the unit; Name: the name of the management unit; Organizations: an array of Organization elements. Each Organization element has the following elements: Id: our internal DB identifier for the organization; Name: the name of the Organization; Acronym: the acronym for the Organization, which may be null; Country: the ISO 3166-1 alpha3 country identifier for where we have the Organization registered; geographical_coverage: Either ‘International’, ‘National’ or ‘Subnational’ to indicate the organization’s authority; subdivision: the ISO 3166-2 alpha2 code for subnational management organizations | An array of Management Units associated within this branch. Each Management Unit has three elements: Id: our internal DB identifier for the unit; Name: the name of the management unit; Organizations: an array of Organization elements. Each Organization element has the following elements: Id: our internal DB identifier for the organization; Name: the name of the Organization; Acronym: the acronym for the Organization, which may be null; Country: the ISO 3166-1 alpha3 country identifier for where we have the Organization registered geographical_coverage: Either ‘International’, ‘National’ or ‘Subnational’ to indicate the organization’s authority; subdivision: the ISO 3166-2 alpha2 code for subnational management organizations |
| datafile | If there is data associated with the Fishery Profile tree, then this returns a JSON hash with the id and a link for the datafile and the date the file was created | If there is data associated with the Fishery Profile tree, then this returns a JSON hash with the id and a link for the datafile and the date the file was created |
| data_owners | An array of Organizations associated with the StockOrAssessmentUnit records | An array of Organizations associated with the AssessmentUnit records |
| source_of_information | An absolute URI to the Profile Tree on FishSource. Please note, for the staging site, these will refer to the staging site. | An absolute URI to the Profile Tree on FishSource. For child node, the URI provided is the URI for the root node. Please also note, for the staging site, these will refer to the staging site. |
| map infos | An array of MAP associated with the tree. Each element specifies the KML path of MAP | An array of MAP associated with the tree. Each element specifies the KML path of MAP |
[{
"id": 1830,
"name": "Capelin - Barents Sea",
"grsf_uuid": "727e6394-2225-3715-8bdb-3716cc6767c9",
"type": "AssessmentUnit",
"node_type": "Root",
"grsf_type": "Assessment Unit",
"species": {
"genus": "Mallotus",
"order": "Salmoniformes",
"family": "Osmeridae",
"code_3a": "CAP",
"fao_name": "Capelin",
"specific_descriptor": "villosus"
},
"assessment_areas": [
{
"id": 49,
"name": "FAO 27.1",
"type": "fao",
"code": "27.1"
},
{
"id": 132,
"name": "FAO 27.2.b",
"type": "fao",
"code": "27.2.b"
},
{
"id": 884,
"name": "GRSF FAO-27.2.aeast",
"type": "grsf",
"code": "FAO-27.2.a.east"
}
],
"exploiting_fisheries": [
4183,
4552,
4553
],
"management_units": [
{
"id": 2155,
"name": "Russia/Norway",
"organizations": [
{
"id": 2430,
"name": "Joint Norwegian-Russian Fishery Commission",
"acronym": "JNRFC",
"country": "NOR",
"geographical_coverage": "International",
"subdivision": null
}
]
}
],
"data_owners": [
{
"id": 2422,
"name": "International Council for the Exploration of the Sea",
"country": "DNK"
},
{
"id": 3556,
"name": "Norwegian Institute of Marine Research",
"country": "NOR"
},
{
"id": 3557,
"name": "Russian Polar Research Institute of Marine Fisheries and Oceanography",
"country": "RUS"
}
],
"datafile": {
"id": 4233,
"date": "2019-04-19",
"link": "https://s3.amazonaws.com/fs4.fishsource.org/uploads/data_file/file/4233/Capelin-Barents_Sea_6_19_mc_.xlsm"
},
"source_of_information": "http://localhost:3000/stock_page/1830",
"map_infos": [
"https://s3.amazonaws.com/fs4.fishsource.org/uploads/map/kml_path/37/Barents_Sea_Capelin.kml"
]
}]