# Insights API (/docs/v3/insights)



### Introduction Vessels Insights API [#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 [#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](/docs/v3/events) 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

<Callout type="warn" title="Important: Data Considerations before drawing conclusions">
  In order to avoid any misinterpretation of these insights, please refer to our [Data Caveats
  here](/docs/v3/general-api-doc/data-caveats#insights-api-fishing-detected-in-no-take-mpas).
</Callout>

#### Insights by vessels [#insights-by-vessels-1]

<OpenAPIPage document="apiv3" operations="[{ path: '/api/v3/insights/vessels', method: 'post' }]" hasHead="false" />

#### Examples [#examples]

* [EXAMPLE 1](/docs/examples/insights/insights-example1) - Get insights for a vessel related to fishing events
* [EXAMPLE 2](/docs/examples/insights/insights-example2) - Get insights for a vessel related to AIS off events
* [EXAMPLE 3](/docs/examples/insights/insights-example3) - Get insights for a vessel related to being listed in IUU list