Stocks

>>>

GET /api/bluebridge/v3/stocks DEPRECATED
View information on all Stocks or Assessment Units

Provides information on all Stocks or Assessment Units (or Unascertained) that are not Salmon related. Draft information is not returned by this endpoint.

The response is an array of JSON objects, each summarising information about a single Fishery Profile tree.

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.

Description of response elements

Element Description
id The internal FishSource identifier for the Stock, AssessmentUnit or Unascertained node at the root of 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.
type Indicates whether the root of the Fishery Profile Tree is a Stock, AssessmentUnit or Unascertained
children An array containing information on any *AssessmentUnit*s nested under the root node
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.
fishing_areas An array of Fishing Areas associated with the tree. Each element specifies the name of the Fishing Area and whether it’s an FAO defined area or Other
exploiting_fisheries An array of internal FishSource identifiers for all Fisheries contained within the Fishery Profile tree
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 alpha3 country identifier for where we have the Organization registered
state_of_marine_resource An array of narrative text (XHTML) associated with the root or children nodes of the Profile Tree related to the Current Status as shown on FishSource. Each array element contains both the narrative text as well as the internal FishSource identifier for the node in the Fishery Profile Tree associated with the text, and also the date of the most recent citation in the text
scientific_advice An array of narrative text (XHTML) associated with the root or children nodes of the Profile Tree related to the Scientific Advice as shown on FishSource. Each array element contains both the narrative text as well as the internal FishSource identifier for the node in the Fishery Profile Tree associated with the text, and also the date of the most recent citation in the text
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
data_owners An array of Organizations associated with the StockOrAssessmentUnit 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.
map infos An array of MAP associated with the tree. Each element specifies the KML path of MAP

Examples

[
  {
    "id": 1830,
    "name": "Capelin - Barents Sea",
    "type": "AssessmentUnit",
    "children": [],
    "species": {
        "fao_name": "Capelin",
        "order": "Salmoniformes",
        "family": "Osmeridae",
        "genus": "mallotus",
        "specific_descriptor": "villosus",
        "code_3a": "CAP"
    },
    "fishing_areas": [
        {
            "name": "FAO 27.1",
            "type": "FAO"
        },
        {
            "name": "FAO 27.2",
            "type": "FAO"
        }
    ],
    "exploiting_fisheries": [
        4183,
        4552,
        4553
    ],
    "management_units": [
        {
            "id": 2155,
            "name": "Russia/Norway",
            "organizations": [
                {
                    "id": 2430,
                    "name": "Joint Norwegian-Russian Fishery Commission",
                    "acronym": "JNRFC",
                    "country": null
                }
            ]
        }
    ],
    "state_of_marine_resource": [
        {
            "text": "<p>The maturing component, assessed in autumn 2016, was estimated at 181,000 tons, below &nbsp;B<sub>lim</sub>. Due to low recruitment, it is expected that the maturing biomass will be well below B<sub>lim</sub> by ~163,000 t for 2017&nbsp;.</p>

<p>Fishing mortality cannot be determined and is not relevant for the management of the stock due to capelin&rsquo;s semelparity (single spawning in its lifetime) and the nature of the fishery.</p>",
            "latest_citation_date": "2016",
            "stock_or_assessment_unit_id": "1830"
        }
    ],
    "scientific_advice": [
        {
            "text": "<p>The stock is assessed by <span class="caps">IMR</span> (Norway) and <span class="caps">PINRO</span> (Russia) (<span class="caps">ICES</span>, 2011b), but scientific advice is provided by <span class="caps">ICES</span> for the winter-spring fishery since 1999 (<span class="caps">ICES</span>, 2014a). As in previous years, <span class="caps">ICES</span> advises the capelin fishery only on mature fish, from January to May (<span class="caps">ICES</span>, 2014b). The Harvest Control Rule (<span class="caps">HCR</span>) established in the management plan is considered as precautionary by <span class="caps">ICES</span> and in 2010 the <span class="caps">JNRFC</span> decided that it &ldquo;should remain unchanged for the following 5 years&rdquo; (<span class="caps">ICES</span>, 2014a).</p>

<p>As for 2016, ICES advice for 2017 was to have no fishery due to low recruitment . This advice, like the recommendation for zero catch in 2016, was based on the acoustic survey. This therefore reflects the second year in a row that the fishery was closed</p>",
            "latest_citation_date": "2016",
            "stock_or_assessment_unit_id": "1830"
        }
    ],
    "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": 3156,
        "link": "https://s3.amazonaws.com/fs4.fishsource.org/uploads/data_file/file/3156/Capelin-Barents_Sea_4_17_mc_20170822002310.xlsm",
        "date": "2017-04-11"
    },
    "source_of_information": "http://www.fishsource.org/stock_page/1830",
    "map_infos": [
        "https://s3.amazonaws.com/fs4.fishsource.org/uploads/map/kml_path/37/Barents_Sea_Capelin.kml"
    ]
  }
  ...
]