GET /api/bluebridge/v6/fisheries/:id
Information about a specific Fishery and associated data

View detailed information on a particular Fishery. The endpoint must be supplied with the ID of the Fishery you want details on, and the response is a single JSON object.

Description of response elements

Element Description
fishery_name The name of the Fishery as presented on FishSource. Comprised of the species FAO or common name, the Stock/Assessment Unit/Unascertained name, the Management Unit name, the Flag country and Gear or GearGroup
grsf_uuid The UUID of the GRSF record associated with this Fishery if approved
exploiting_stocks The ID of the Stock, Assessment Unit or Unascertained element at the root of the Fishery Profile Tree
prod_system_type One of either Artesanal, Industrial or blank
flag_state The alpha3 ISO 3166 code for the Flag country of the Fishery
fishing_gear A JSON element capturing the id (internal FishSource identifier), name, standard abbreviation and ISSCFG code for the Gear or Gear Group associated with the Fishery and as distinguished by the gear_type (either Gear or GearGroup)
management_unit The detail of the Management unit for this Fishery
management_areas An array of the Management areas that constitute this Fishery and which are associated with the ManagementUnit for the Fishery. Each element specifies the id, name, type and code of the Management Area.
map_info KML path for MAP at first child node of Profile tree
annual_catch Either null, or an array of Fishery Removals related data points, grouped by each node on the Profile Tree branch that constitutes the Fishery. Each element with the annual_catch array lists the type and id of the node, and then the data points are returned in an array bound to the data key

The possible variables that might be returned for the Fishery Removals data are:

  1. Catch (’000 t)
  2. Catch (M individuals)
  3. Estimated catch (’000 t)
  4. Landings (’000 t)
  5. Reported catch (’000 t)
  6. Reported landings (’ 000 t)

Examples

{
  "fishery_name": "Capelin | Barents Sea | Russia/Norway | Russian Federation | Purse seines",
  "grsf_uuid": null,
  "exploiting_stocks": 1830,
  "prod_system_type": "",
  "flag_state": "RUS",
  "fishing_gear": {
      "id": 68,
      "name": "Purse seines",
      "standard_abbreviation": "PS",
      "isscfg": "01.1",
      "gear_type": "Gear",
      "sfp_gear": null
  },
  "management_unit": {
      "id": 2155,
      "name": "Russia/Norway",
      "organizations": [
          {
              "id": 2430,
              "name": "Joint Norwegian-Russian Fishery Commission",
              "acronym": "JNRFC",
              "country": null,
              "geographical_coverage": null,
              "subdivision": null
          }
      ]
  },
  "management_areas": [
      {
          "id": 49,
          "name": "FAO 27.1",
          "type": "fao",
          "code": "27.1"
      },
      {
          "id": 59,
          "name": "FAO 27.2",
          "type": "fao",
          "code": "27.2"
      }
  ],
  "map_info": "https://s3.amazonaws.com/fs4.fishsource.org/uploads/map/kml_path/37/Barents_Sea_Capelin.kml",
  "annual_catch": [
      {
          "object_id": 1830,
          "object_type": "StockOrAssessmentUnit",
          "data": [
              {
                  "year": 1965,
                  "Estimated catch ('000 t)": 224
              },
              {
                  "year": 1966,
                  "Estimated catch ('000 t)": 389
              },
              {
                  "year": 1967,
                  "Estimated catch ('000 t)": 409
              },
              ...
          ]
      }
  ]
}

Params

Param name Description
id
required

A valid identifier as returned from the STOCKS endpoint

Validations:

  • Must be Integer