Insights by vessels

Get vessels insights that fuse AIS activity, identity and public authorizations into risk indicators for IUU fishing due diligence.

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 Examples

EXAMPLE 1 - Get insights for a vessel related to fishing events
EXAMPLE 2 - Get insights for a vessel related to AIS off events
EXAMPLE 3 - Get insights for a vessel related to being listed in IUU list

Insights by vessels - Specifications

Authorization

ApiKeyAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

confidences?array<number>

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

endDate?string

Formatdate-time

includes?array<string>

This 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-LIST

startDate?string

Formatdate-time

vessels*array<>

curl -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"  }}

Insights Examples

Insights by vessels - Specifications

Authorization

Request Body

On this page