Get one vessel by ID

Get one vessel and retrieve identity details, combining GFW AIS identity data with over 40 public regional and national registries.

After you perform a Vessel Search , you get the vessel id, for example c54923e64-46f3-9338-9dcb-ff09724077a3. You can use this endpoint to get the details of ONE vessel id.

Example: Get details of one vessel

curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v3/vessels/c54923e64-46f3-9338-9dcb-ff09724077a3?dataset=public-global-vessel-identity:latest' \
  -H "Authorization: Bearer [TOKEN]"

result = await gfw_client.vessels.get_vessel_by_id(
    id="c54923e64-46f3-9338-9dcb-ff09724077a3",
    dataset="public-global-vessel-identity:latest",
)

gfw_vessel_info(search_type = "id",
                ids = c("c54923e64-46f3-9338-9dcb-ff09724077a3"))

// Make sure to replace [TOKEN] with your API Access Token.
const res = await fetch(
  'https://gateway.api.globalfishingwatch.org/v3/vessels/c54923e64-46f3-9338-9dcb-ff09724077a3?dataset=public-global-vessel-identity:latest',
  { headers: { Authorization: 'Bearer [TOKEN]' } }
)
const data = await res.json()

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "dataset": "public-global-vessel-identity:v20230623",
  "registryInfoTotalRecords": 0,
  "registryInfo": [],
  "registryOwners": [],
  "registryAuthorizations": [],
  "selfReportedInfo": [
    {
      "id": "c54923e64-46f3-9338-9dcb-ff09724077a3",
      "ssvid": "775998121",
      "shipname": "DON TITO",
      "nShipname": "DONTITO",
      "flag": "VEN",
      "callsign": "YD23136",
      "imo": null,
      "geartype": null,
      "shiptype": "OTHER_NON_FISHING",
      "messagesCounter": 1103,
      "positionsCounter": 430,
      "shiptypesByYear": [
        {
          "shiptype": "OTHER_NON_FISHING",
          "years": [2021, 2022, 2023]
        }
      ],
      "sourceCode": ["AIS"],
      "matchFields": "NO_MATCH",
      "transmissionDateFrom": "2021-08-06T10:49:26Z",
      "transmissionDateTo": "2023-09-21T14:52:16Z"
    }
  ]
}

Get vessel by id - Specifications

Authorization

ApiKeyAuth

AuthorizationBearer <token>

In: header

The response doesn't include all registry info data by default. It means, the default value is NONE. You can use DELTA to get only the data that changes in the time or ALL to get all data from the registries

Value in

"NONE"
"DELTA"
"ALL"

includes?array<string>

This query param allows to add extra information to the response. Possible values: POTENTIAL_RELATED_SELF_REPORTED_INFO

binary?boolean

If the response should be in binary format (proto buffer) or not. It is useful if you want to improve the performance of your platform. A decoder is needed to transform the response. Default is False

match-fields?array<string>

This query param allows to filter by matchFields levels. Possible values: ID_MATCH_ONLY, SEVERAL_FIELDS, NO_MATCH, ALL. It is allow to use with query query-param but not with where query-param

dataset*string

Specify the dataset that will be used to search the vessel. You can learn more about which are the possible datasets here.

curl -X GET "https://example.com/v3/vessels/string?dataset=public-global-fishing-vessels%3Alatest"

{  "combinedSourcesInfo": [    {      "geartypes": [        {          "name": "OTHER",          "source": "GFW_OTHER_LIST",          "yearFrom": "2012",          "yearTo": "2023"        },        {          "name": "GEAR",          "source": "GFW_FISHING_LIST",          "yearFrom": "2013",          "yearTo": "2023"        }      ],      "inferredVesselClassAgNnet": [        {          "source": "AIS_INFERRED_NN_INFO",          "value": "TUNA_PURSE_SEINES",          "yearFrom": 2012,          "yearTo": 2025        }      ],      "onFishingListSr": [        {          "source": "GFW_VESSEL_LIST",          "value": true,          "yearFrom": 2012,          "yearTo": 2025        }      ],      "prodGeartypeSource": [        {          "source": "COMBINATION_OF_REGISTRY_AND_AIS_INFERRED_NN_INFO",          "value": "GFW_RESEARCH_VI_SSVID_BEST_VESSEL_CLASS",          "yearFrom": 2012,          "yearTo": 2025        }      ],      "registryVesselClass": [        {          "source": "REGISTRY",          "value": "OTHER_FISHING|PURSE_SEINES",          "yearFrom": 2012,          "yearTo": 2025        }      ],      "shiptypes": [        {          "name": "OTHER",          "source": "GFW_OTHER_LIST",          "yearFrom": "2012",          "yearTo": "2023"        },        {          "name": "FISHING",          "source": "GFW_FISHING_LIST",          "yearFrom": "2013",          "yearTo": "2023"        }      ],      "vesselId": "SINAR LAUTAN ABADI"    }  ],  "dataset": "proto-global-vessel-identity:latest",  "registryExtraFields": [    {}  ],  "registryInfo": [    {      "callsign": "Y4EO",      "extraFields": [        {}      ],      "flag": "DEU",      "geartypes": [        "trawlers"      ],      "id": "9e075a986-6162-fe6e-b25e-81188438a00c",      "imo": null,      "latestVesselInfo": true,      "lengthM": 26.4,      "nShipname": "STERNHAI",      "shipname": "STERNHAI",      "ssvid": "211307720",      "tonnageGt": 121,      "transmissionDateFrom": "2012-05-25 15:16:29 UTC",      "transmissionDateTo": "2014-06-30 08:51:05 UTC",      "vesselInfoReference": "3023ab41b367d8f2d62d2a60c67c711f"    }  ],  "registryInfoTotalRecords": 3,  "registryOwners": [    {      "dateFrom": "2014-06-30T00:00:00Z",      "dateTo": "2015-09-30T00:00:00Z",      "flag": "IDN",      "name": "SINAR LAUTAN ABADI",      "sourceCode": "IDN-1104",      "ssvid": "211307720"    }  ],  "registryPublicAuthorizations": [    {      "dateFrom": "2012-05-25T00:00:00Z",      "dateTo": "2014-06-30T00:00:00Z",      "sourceCode": "IDN-1104",      "ssvid": "211307720"    }  ],  "selfReportedInfo": {    "callsign": "Y4EO",    "flag": "DEU",    "id": "9e075a986-6162-fe6e-b25e-81188438a00c",    "imo": null,    "messagesCounter": 1284,    "nShipname": "STERNHAI",    "positionsCounter": 894,    "shipname": "STERNHAI",    "sourceCode": [      "AIS"    ],    "ssvid": "211307720",    "transmissionDateFrom": "2012-05-25 15:16:29 UTC",    "transmissionDateTo": "2014-06-30 08:51:05 UTC"  }}

Example: Get details of one vessel

Get vessel by id - Specifications

Authorization

Path Parameters

Query Parameters

On this page