Insights API
Vessel insights that fuse AIS activity, identity and public authorizations into risk indicators for IUU fishing due diligence.
Introduction Vessels Insights API
The Insights API is a set of indicators or 'vessel insights' that bring together important information on a vessel's known activity (based on AIS), vessel identity information and public authorizations. The objective of the insights is to support risk-based decision-making, operational planning, and other due diligence activities by making it easier for a user to identify vessel characteristics that can indicate an increased potential or opportunity for a vessel to engage in IUU (Illegal, Unreported, or Unregulated) fishing. The vessel insights were originally developed in collaboration with TMT, the Ocean Risk & Resilience Action Alliance (ORRAA) and representatives from the insurance industry. The project aimed to strengthen an insurance underwriter's ability to assess the potential that a vessel they insure may engage in or support IUU fishing. The collaboration included a pilot whereby insurance underwriters were asked to provide feedback on Vessel Viewer and the utility of the insights. The insights were then expanded for testing by port inspectors, MCS officers, the seafood industry, and others, with feedback from all pilot groups informing improvements and future efforts.
Insights by vessels
This endpoint allow to get vessel insights for one or several vessel_ids. You can define what insight you want to get. It will return a list of events, you can use Events API to get the details of the event.
These are the available insights:
-
Any apparent fishing events in no-take MPAs
-
Any apparent fishing events detected in areas with no known RFMO authorization
-
The vessel’s AIS coverage metric
-
Any AIS off events
-
If the vessel is present on an RFMO IUU vessel list
Important: Data Considerations before drawing conclusions
In order to avoid any misinterpretation of these insights, please refer to our Data Caveats here.
Insights by vessels
Authorization
ApiKeyAuth In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
This param applies only to port visits events, check data caveats to understand the different levels. Values go from 2 to 4, where 2 is low confidence, 3 is medium and 4 is high confidence. Values are separated by comma. Possible values: 2, 3, 4
date-timeThis query param allows the user to request one or multiple insights in one request. You can use it to avoid calculatingall insights in case you just need one. Possible values: FISHING, GAP, COVERAGE, VESSEL-IDENTITY-FLAG-CHANGES, VESSEL-IDENTITY-IUU-VESSEL-LIST, VESSEL-IDENTITY-MOU-LISTdate-timecurl -X POST "https://example.com/api/v3/insights/vessels" \ -H "Content-Type: application/json" \ -d '{ "vessels": [ { "datasetId": "public-global-fishing-vessels:20211001", "vesselId": "d381c84ba-a8fe-c027-2947-2bbbc59d4182" } ] }'{ "apparentFishing": { "datasets": [ "public-global-fishing-events:v20201001" ], "eventsInNoTakeMpas": [], "eventsInRfmoWithoutKnownAuthorization": [], "periodSelectedCounters": { "events": 100, "eventsInNoTakeMPAs": 5, "eventsInRFMOWithoutKnownAuthorization": 10 }, "vesselId": "5655157e5-5c1f-96be-7354-3f64f04673a7" }, "coverage": { "blocks": [ 7 ], "blocksWithPositions": [ 5 ], "percentage": 99.8, "vesselId": "5655157e5-5c1f-96be-7354-3f64f04673a7" }, "gaps": { "aisOff": [ "05991c8f5d625c4eef5f8dcaad736f0f", "d3025fc6eec92f6192fe9e828329e9f8", "5c9498c0e89c62153a6716a8d754e43d", "431742af8d1ddc951e35a13816f49e5d", "05eb3d178dc1c06557c56eaeed49176b", "5c9b1ee2d51bdc7a2ed126c48e13bf92", "4ac670ee8cc4122d8f0550c6a98fd9b1", "96dc07132a63fd8c0c1d304bc3c75fea", "27eeb864475a39e0b5911ef9725a21ac", "8a1b7a4acbc6a613ad1585ceeaa28eca", "25e5f1fca1df3aa0689434078a3196f7" ], "datasets": [ "public-global-fishing-events:v20201001" ], "historicalCounters": { "events": 100, "eventsInNoTakeMPAs": 5, "eventsInRFMOWithoutKnownAuthorization": 10 }, "periodSelectedCounters": { "events": 100, "eventsInNoTakeMPAs": 5, "eventsInRFMOWithoutKnownAuthorization": 10 }, "vesselId": "5655157e5-5c1f-96be-7354-3f64f04673a7" }, "period": { "endDate": "2023-01-01" }, "vesselIdentity": { "datasets": [ "public-global-fishing-events:v20201001" ], "flagsChanges": { "totalTimesListed": 10, "totalTimesListedInThePeriod": 1, "valuesInThePeriod": [ { "from": "2012-01-19T14:24:39Z", "to": "2024-03-04T23:59:41Z", "value": "CHL" } ] }, "iuuVesselList": { "totalTimesListed": 2, "totalTimesListedInThePeriod": 1, "valuesInThePeriod": [ { "from": "2012-01-19T14:24:39Z", "to": "2024-03-04T23:59:41Z" } ] }, "mouList": { "paris": { "totalTimesListed": 3, "totalTimesListedInThePeriod": 3, "valuesInThePeriod": [ { "from": "2022-12-08T13:38:20.000Z", "to": "2023-11-30T22:27:07.000Z", "value": "grey" }, { "from": "2022-06-10T06:49:22.000Z", "to": "2022-12-08T13:13:31.000Z", "value": "grey" }, { "from": "2022-06-10T06:49:22.000Z", "to": "2022-12-08T13:13:31.000Z", "value": "grey" } ] }, "tokyo": { "totalTimesListed": 3, "totalTimesListedInThePeriod": 3, "valuesInThePeriod": [ { "from": "2022-12-08T13:38:20.000Z", "to": "2023-11-30T22:27:07.000Z", "value": "black" }, { "from": "2022-06-10T06:49:22.000Z", "to": "2022-12-08T13:13:31.000Z", "value": "grey" }, { "from": "2022-06-10T06:49:22.000Z", "to": "2022-12-08T13:13:31.000Z", "value": "grey" } ] } }, "vesselId": "5655157e5-5c1f-96be-7354-3f64f04673a7" }}