Get longline set events for a vessel (GET)

Example GET request for longline set events of a single vessel over a date range.

Query parameters

Parameter	Value	Description
`datasets[0]`	`public-global-longline-fishing-events:latest`	Longline set events dataset
`vessels[0]`	`555c6123f-f247-9779-4e93-d9483bb1aa0a`	Vessel id to filter events for
`limit`	`2`	Max number of events returned
`offset`	`0`	Pagination offset

Request

# Make sure to replace [TOKEN] with your API Access Token.
curl --location --globoff 'https://gateway.api.globalfishingwatch.org//v3/events?start-date=2020-01-12&end-date=2021-05-20&limit=2&offset=0&vessels[0]=555c6123f-f247-9779-4e93-d9483bb1aa0a&datasets[0]=public-global-longline-fishing-events%3Alatest' \
  -H "Authorization: Bearer [TOKEN]"

Response

{
 {
    "metadata": {
        "datasets": [
            "public-global-longline-fishing-events:v5.0"
        ],
        "vessels": [
            "555c6123f-f247-9779-4e93-d9483bb1aa0a"
        ],
        "dateRange": {
            "from": "2020-01-12",
            "to": "2021-05-20"
        }
    },
    "limit": 2,
    "offset": 0,
    "nextOffset": 2,
    "total": 261,
    "entries": [
        {
            "start": "2020-03-20T00:49:28.000Z",
            "end": "2020-03-20T08:02:56.000Z",
            "id": "f97dc029f51742e74c1799c0ffb5b14a",
            "type": "fishing",
            "position": {
                "lat": -38.2322,
                "lon": 68.7201
            },
            "regions": {
                "mpa": [],
                "eez": [],
                "rfmo": [
                    "ACAP",
                    "CCSBT",
                    "CCSBT-Primary-Area",
                    "IWC",
                    "SIOFA",
                    "IOTC"
                ],
                "fao": [
                    "51.7",
                    "51"
                ],
                "majorFao": [
                    "51"
                ],
                "eez12Nm": [],
                "highSeas": [
                    "high_seas"
                ],
                "mpaNoTakePartial": [],
                "mpaNoTake": [],
                "ebsa": [
                    "SIO_11"
                ],
                "imma": [],
                "dukePaa": [],
                "protectedseas": [
                    "AIHSMA105",
                    "AIHSEBSA39",
                    "AIHSTREATY36",
                    "AIHSTREATY13",
                    "AIHSTREATY28",
                    "AIHSTREATY42",
                    "AIHSTREATY12"
                ],
                "hsp": [],
                "fraGfcmFao": []
            },
            "boundingBox": [
                68.5695633333,
                -38.3588183333,
                69.002015,
                -38.080306666666665
            ],
            "distances": {
                "startDistanceFromShoreKm": 780,
                "endDistanceFromShoreKm": 746,
                "startDistanceFromPortKm": 2134.31175,
                "endDistanceFromPortKm": 2115.7215
            },
            "vessel": {
                "id": "555c6123f-f247-9779-4e93-d9483bb1aa0a",
                "name": "DE YI NO.16",
                "ssvid": "416004624",
                "flag": "TWN",
                "type": "fishing",
                "publicAuthorizations": [
                    {
                        "hasPubliclyListedAuthorization": "true",
                        "rfmo": "IOTC"
                    },
                    {
                        "hasPubliclyListedAuthorization": "false",
                        "rfmo": "CCSBT"
                    }
                ],
                "nextPort": null
            },
            "fishing": {
                "totalDistanceKm": 85.06920024922138,
                "averageSpeedKnots": 7.160714265275001,
                "averageDurationHours": null,
                "potentialRisk": false,
                "vesselPublicAuthorizationStatus": "partially_matched",
                "dayNightSummary": "entirely_day",
                "nauticalDawnUtc": "00:33",
                "nauticalDuskUtc": "14:34",
                "localStartHours": 5.405833333333334,
                "localEndHours": 12.630277777777778
            }
        },
        {
            "start": "2020-03-20T23:49:27.000Z",
            "end": "2020-03-21T07:21:38.000Z",
            "id": "d9eabd91e7f9dfe585d6637130c9b051",
            "type": "fishing",
            "position": {
                "lat": -38.2978,
                "lon": 68.9649
            },
            "regions": {
                "mpa": [],
                "eez": [],
                "rfmo": [
                    "SIOFA",
                    "ACAP",
                    "CCSBT",
                    "IWC",
                    "CCSBT-Primary-Area",
                    "IOTC"
                ],
                "fao": [
                    "51",
                    "51.7"
                ],
                "majorFao": [
                    "51"
                ],
                "eez12Nm": [],
                "highSeas": [
                    "high_seas"
                ],
                "mpaNoTakePartial": [],
                "mpaNoTake": [],
                "ebsa": [
                    "SIO_11"
                ],
                "imma": [],
                "dukePaa": [],
                "protectedseas": [
                    "AIHSEBSA39",
                    "AIHSTREATY12",
                    "AIHSTREATY28",
                    "AIHSTREATY36",
                    "AIHSTREATY13",
                    "AIHSTREATY42",
                    "AIHSMA105"
                ],
                "hsp": [],
                "fraGfcmFao": []
            },
            "boundingBox": [
                68.86493166666666,
                -38.4856166667,
                69.05952833333333,
                -38.137265
            ],
            "distances": {
                "startDistanceFromShoreKm": 753,
                "endDistanceFromShoreKm": 741,
                "startDistanceFromPortKm": 2155.12725,
                "endDistanceFromPortKm": 2122.28825
            },
            "vessel": {
                "id": "555c6123f-f247-9779-4e93-d9483bb1aa0a",
                "name": "DE YI NO.16",
                "ssvid": "416004624",
                "flag": "TWN",
                "type": "fishing",
                "publicAuthorizations": [
                    {
                        "hasPubliclyListedAuthorization": "false",
                        "rfmo": "CCSBT"
                    },
                    {
                        "hasPubliclyListedAuthorization": "true",
                        "rfmo": "IOTC"
                    }
                ],
                "nextPort": null
            },
            "fishing": {
                "totalDistanceKm": 89.4199126423705,
                "averageSpeedKnots": 7.333333362230302,
                "averageDurationHours": null,
                "potentialRisk": false,
                "vesselPublicAuthorizationStatus": "partially_matched",
                "dayNightSummary": "mostly_day",
                "nauticalDawnUtc": "00:32",
                "nauticalDuskUtc": "14:33",
                "localStartHours": 4.421944444444445,
                "localEndHours": 11.958333333333332
            }
        }
    ]
}
}