Global Fishing Watch API
ExamplesInsights

Get insights for a vessel related to longline set events

Example Insights request returning longline set indicators for one vessel over a date range.

Request body

FieldValueDescription
includes["LONGLINE-SETS"]Insight type to include: longline set events
startDate2020-01-01Start of the period to analyze
endDate2020-07-11End of the period to analyze
vessels[0].datasetIdpublic-global-vessel-identity:latestVessel identity dataset
vessels[0].vesselId555c6123f-f247-9779-4e93-d9483bb1aa0aVessel id to get insights for

Request

# Make sure to replace [TOKEN] with your API Access Token.
curl --location 'https://gateway.api.globalfishingwatch.org//v3/insights/vessels' \
--header 'Authorization: Bearer [TOKEN]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "includes": [ "LONGLINE-SETS"],
    "confidences": [],
    "startDate": "2020-01-01",
    "endDate": "2020-07-11",
    "vessels": [
    {"datasetId":"public-global-vessel-identity:latest","vesselId":"555c6123f-f247-9779-4e93-d9483bb1aa0a"} 
    ]
}'

Response

{
    "period": {
        "startDate": "2020-01-01",
        "endDate": "2020-07-11"
    },
    "vesselIdsWithoutIdentity": null,
    "apparentLongLineSetEvents": {
        "datasets": [
            "public-global-longline-fishing-events:v5.0"
        ],
        "count": 76,
        "entirelyDay": {
            "count": 12,
            "entries": [
                "282a373a52f351bc69c6a4405393263c",
                "b6427de824bcd1c4e53980498cd3a79c",
                "f97dc029f51742e74c1799c0ffb5b14a",
                "8a4ff8430bd38127b078d720a6ab90aa",
                "9e648cbac454af7092f963a8c6720428",
                "7713fc3a496ebfccced9b8d46bd6059b",
                "01fbb591d3dd7c5bed1c7cae05e5a760",
                "942d368fdc64438f64189bd58e4c6869",
                "18eccca1222a17e09a0ce64eeadbb2e4",
                "dcd27f0954e4452c66cb3fcad60d95cb",
                "b72feea5b81fe4ca729cc154405561a8",
                "5070deb9b912c7b7d2340106b054eccc"
            ]
        },
        "mostlyDay": {
            "count": 45,
            "entries": [
                "592d0610fa9bd8f1723efd1265e4dc85",
                "1e53fab2b7d3e30e59cbbe4d17240a62",
                "70fd970ffd9a86a29b8f6073fb49036c",
                "bc137c1da71767732e225fdcc97ca0d6",
                "4ab9b7f449428e2ae23533cea11db696",
                "90eff420f1bec7b7ec0e548d32e6e7ef",
                "2922603c3814332eb85c1d5b1f7ad36e",
                "d9eabd91e7f9dfe585d6637130c9b051",
                "820c7dceb4bbf10711b470049438b5fb",
                "aa8bc94eb8b8117ecfe3609b7e5bf4d4",
                "76702a072558b86835d41daadba2867b",
                "4f0f402a90338b41c20d49984438a4b7",
                "83d4c5fd3c63a977769e7c23e4fbaa83",
                "821efa38cf9e8bbb9e600ac61563a95e",
                "1b723da270ca847fb25ae0b28f599f38",
                "e11ceec407fe7c612d7852db4371b790",
                "bb7806f2e89e186a0d55e73c0d43c03e",
                "7218d0479dd571d15bff33dedc3c7374",
                "342f5de757c2a78337bb9cf5d8cc1721",
                "888f9c4af5a1d2c509f84614aae4cbf1",
                "61134c61896554025a47fd25ac6b7a58",
                "88d09095d5e9ed8fddb5c61c15c7b01a",
                "2bf2d1ef00015aca99f4f0cb1e1538bb",
                "76c613686833fe60b8400711da3cf1dc",
                "a6c96276982102fcde250ee31e9165a3",
                "ebfb441bb0d0c4a518a57a35295e2be3",
                "c163aac3ebdd925c002b737575b56365",
                "f1a437953ac97d4bf15b562c44a07c17",
                "8eb521283fa13af08892058e4c6c8ce8",
                "c8e702e9436ded7786ded98740cef9b7",
                "244d8c5853bff0faaf6f35ee516fa1b4",
                "52569aa37bf348a0de816f93082353f1",
                "fc06104ffe01e6df7b0af76a8c5a4ae4",
                "b4c5b28574c0f7069f57bd049be4aad6",
                "442c74e0a68650a241afca49acbc8ac5",
                "555c9bcc94fd2fb3c9dd57ef11d60334",
                "92149413d3c3bd584894a57c337fdf93",
                "62fa9984dc961fceab627e7d5b45d250",
                "46b2a3b4a47f5843b35f1b655a28c6bb",
                "a1bcd29e6c0fae761db20622c3baf75c",
                "2509f9c6f8e1f232dbf228c095713dc0",
                "a5da0a2453d0d9952c366b06d296813d",
                "84c957fd2c3e7a28ccde15f2bf5f6ce4",
                "8f06076b0dce53f329c07abed587381c",
                "5463d32eac089cafb419f1f1cff1b041"
            ]
        },
        "dayAndNight": {
            "count": 16,
            "entries": [
                "9618a52ea0f882f284324e47b309236c",
                "f8dc4d5619fd69c34deef4b45344f56f",
                "53ecfca0e58886e9716b07efd230531a",
                "64236c04b2e0012a9e1397e8e4c2754f",
                "36ca0731ba45b53f2604ec77de63a6b3",
                "3a0b8704a27ec9358f77ef71abf45256",
                "65fe04bf8870766b604f187928587b14",
                "824dec32e89a2d97ab780074fca42557",
                "3ae4a770eaf16a9bb59e53cc20f9fa10",
                "7cfb4339787d5a4bc1e27b16f1132e49",
                "1b54b7def3f437cb4c1056805a9e239f",
                "feabd651b4875d765a23e6236571eaa9",
                "7269e1e971571f5083f9365fcc47644d",
                "fc29d5f8185a4641e1e61a2607daeafd",
                "44b77a38f18d970aeaf53d464d036988",
                "f82c5937d406ce139f654a673ad3c027"
            ]
        },
        "mostlyNight": {
            "count": 2,
            "entries": [
                "5fe695134645ec203da79050674dc68c",
                "09f3f358463649041209216ff4f267e9"
            ]
        },
        "entirelyNight": {
            "count": 1,
            "entries": [
                "4d047be7bb9f6205be30b375a496d24a"
            ]
        },
        "unclassified": {
            "count": 0,
            "entries": []
        }
    }
}