GET /api/bluebridge/v1/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 Organizations that are associated with management units within this stock
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.
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.
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
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": 1080,
    "name": "Pacific Cod - Aleutian Islands",
    "type": "AssessmentUnit",
    "children": [],
    "species": {
      "fao_name": "Pacific Cod",
      "order": null,
      "family": null,
      "genus": "lithodes",
      "specific_descriptor": "aequispinus",
      "code_3a": null
    },
    "fishing_areas": [
      {
        "name": "Aleutian Islands Area O",
        "type": "Other"
      },
      {
        "name": "FAO 67",
        "type": "FAO"
      }
    ],
    "exploiting_fisheries": [
      2496,
      2506
    ],
    "management_units": [
      {
        "id": 3300,
        "name": "Alaska Department of Fish and Game",
        "acronym" : 'ADF&G',
        "country": "US"
      }
    ],
    "state_of_marine_resource": [
      {
        "text": "<p>Status of this stock is unknown given the lack of reference points and lack of a quantified model(Pengilly, 2013). Adding some changes here. And some more changes now. Getting rid of breaking changes.</p>",
        "stock_or_assessment_unit_id": "1080"
      }
    ],
    "scientific_advice": [
      {
        "text": "<p>No formalized assessment or projections are used.<br />
Quotas are based entirely on historical catch and are not reflective of stock health (Pengilly, 2013).</p>"
      }
    ],
    "datafile": {
      "id": 1220,
      "link": "https://s3.amazonaws.com/fs4.fishsource.org/uploads/data_file/file/1220/template.xlsm"
    },
    "data_owners": [
      {
        "id": 12,
        "name": "ACME INC",
        "country": "US"
      }
    ]
    "source_of_information": "http://localhost:3000/stock_page/1080",
    "map_infos": [
      "https://s3.amazonaws.com/fs4.fishsource.org/uploads/map/kml_path/1123/Acadian_Redfish_GoSL_LC.kml",
      ..
    ]
  },
  ...
]