Skip to content

Instantly share code, notes, and snippets.

@giselamo
Created July 4, 2023 16:20
Show Gist options
  • Save giselamo/069d1afd565484325c8030360c458381 to your computer and use it in GitHub Desktop.
Save giselamo/069d1afd565484325c8030360c458381 to your computer and use it in GitHub Desktop.
Vessel API v3 PROTOTYPE basic search example
curl --location -g --request GET 'https://gateway.api.staging.globalfishingwatch.org/prototypes/vessels/search/?datasets[0]=proto-global-vessel-identity:latest&query=412440489&includes[0]=MATCH_CRITERIA&includes[1]=AUTHORIZATIONS&includes[2]=OWNERSHIP' \
--header 'Authorization: Bearer [YOUR TOKEN]'
{
"total": 2,
"limit": 20,
"since": null,
"metadata": {
"query": "412440489",
"normalizedQuery": "412440489",
"didYouMean": {
"shipname": {}
}
},
"entries": [
{
"registryInfoTotalRecords": 1,
"registryInfo": [
{
"recordId": "IMO-8567846",
"sourceCode": [
"GFW-REVIEW",
"IMO"
],
"ssvid": "412440489",
"flag": "CHN",
"shipname": "FU YUAN YU 827",
"nShipname": "FUYUANYU827",
"callsign": "BZUS6",
"imo": "8567846",
"latestVesselInfo": true,
"transmissionDateFrom": "2015-01-17T22:02:30Z",
"transmissionDateTo": "2023-03-31T02:35:40Z",
"geartype": "FISHING",
"shiptype": "FISHING",
"lengthM": null,
"tonnageGt": 1128,
"vesselInfoReference": "c468bce3-8bb0-47ef-b39a-3560265f39cc"
}
],
"registryOwners": [
{
"owner": "XIAMEN HAIXINTIAN PELAGIC",
"ownerFlag": "CHN",
"sourceCode": [
"IMO"
]
}
],
"coreInfo": [
{
"id": "ea2de8723-3f92-5b17-23ab-e33988adcf98",
"ssvid": "412440489",
"shipname": "FU YUAN YU 827",
"nShipname": "FUYUANYU827",
"flag": "CHN",
"callsign": "0",
"imo": "0",
"geartype": "FISHING",
"shiptype": "FISHING",
"sourceCode": [
"AIS"
],
"firstTransmissionDate": "2014-08-27T00:21:20Z",
"lastTransmissionDate": "2023-06-28T23:52:58Z",
"matchFields": "SEVERAL_FIELDS"
},
{
"id": "496b27ed4-45d9-671b-f617-51a259511934",
"ssvid": "412440489",
"shipname": null,
"nShipname": null,
"flag": "CHN",
"callsign": null,
"imo": null,
"geartype": "FISHING",
"shiptype": "FISHING",
"sourceCode": [
"AIS"
],
"firstTransmissionDate": "2015-07-17T10:03:12Z",
"lastTransmissionDate": "2023-03-25T03:02:09Z",
"matchFields": "ID_MATCH_ONLY"
}
],
"matchCriteria": [
{
"reference": "ea2de8723-3f92-5b17-23ab-e33988adcf98",
"property": "coreInfo.id",
"source": "coreInfo",
"matches": [
{
"property": "coreInfo.ssvid",
"value": "412440489"
}
],
"period": {
"dateFrom": "2014-08-27T00:21:20Z",
"dateTo": "2023-06-28T23:52:58Z"
},
"latestVesselInfo": true
},
{
"reference": "496b27ed4-45d9-671b-f617-51a259511934",
"property": "coreInfo.id",
"source": "coreInfo",
"matches": [
{
"property": "coreInfo.ssvid",
"value": "412440489"
}
],
"period": {
"dateFrom": "2015-07-17T10:03:12Z",
"dateTo": "2023-03-25T03:02:09Z"
},
"latestVesselInfo": true
},
{
"reference": "c468bce3-8bb0-47ef-b39a-3560265f39cc",
"property": "registryInfo.vesselInfoReference",
"source": "registryInfo",
"matches": [
{
"property": "registryInfo.ssvid",
"value": "412440489"
}
],
"period": {
"dateFrom": "2015-01-17T22:02:30Z",
"dateTo": "2023-03-31T02:35:40Z"
},
"latestVesselInfo": true
}
]
},
{
"registryInfoTotalRecords": 1,
"registryInfo": [
{
"recordId": "NPFC-472",
"sourceCode": [
"GFW-REVIEW",
"NPFC",
"RESEARCH-PAPER"
],
"ssvid": "412440489",
"flag": "CHN",
"shipname": "FU YUAN YU 827",
"nShipname": "FUYUANYU827",
"callsign": "BVJO8",
"imo": null,
"latestVesselInfo": true,
"transmissionDateFrom": "2015-01-17T22:02:30Z",
"transmissionDateTo": "2023-03-31T02:35:40Z",
"geartype": "SQUID_JIGGER",
"shiptype": "FISHING",
"lengthM": 59.3,
"tonnageGt": 1128,
"vesselInfoReference": "e33ca2a0-f922-49b1-813a-c2a48725986b"
}
],
"registryOwners": [
{
"owner": "PME PINGTAN MARINE ENTERPRISE",
"ownerFlag": "CHN",
"sourceCode": [
"RESEARCH-PAPER"
]
}
],
"coreInfo": [
{
"id": "ea2de8723-3f92-5b17-23ab-e33988adcf98",
"ssvid": "412440489",
"shipname": "FU YUAN YU 827",
"nShipname": "FUYUANYU827",
"flag": "CHN",
"callsign": "0",
"imo": "0",
"geartype": "FISHING",
"shiptype": "FISHING",
"sourceCode": [
"AIS"
],
"firstTransmissionDate": "2014-08-27T00:21:20Z",
"lastTransmissionDate": "2023-06-28T23:52:58Z",
"matchFields": "SEVERAL_FIELDS"
},
{
"id": "496b27ed4-45d9-671b-f617-51a259511934",
"ssvid": "412440489",
"shipname": null,
"nShipname": null,
"flag": "CHN",
"callsign": null,
"imo": null,
"geartype": "FISHING",
"shiptype": "FISHING",
"sourceCode": [
"AIS"
],
"firstTransmissionDate": "2015-07-17T10:03:12Z",
"lastTransmissionDate": "2023-03-25T03:02:09Z",
"matchFields": "ID_MATCH_ONLY"
}
],
"matchCriteria": [
{
"reference": "ea2de8723-3f92-5b17-23ab-e33988adcf98",
"property": "coreInfo.id",
"source": "coreInfo",
"matches": [
{
"property": "coreInfo.ssvid",
"value": "412440489"
}
],
"period": {
"dateFrom": "2014-08-27T00:21:20Z",
"dateTo": "2023-06-28T23:52:58Z"
},
"latestVesselInfo": true
},
{
"reference": "496b27ed4-45d9-671b-f617-51a259511934",
"property": "coreInfo.id",
"source": "coreInfo",
"matches": [
{
"property": "coreInfo.ssvid",
"value": "412440489"
}
],
"period": {
"dateFrom": "2015-07-17T10:03:12Z",
"dateTo": "2023-03-25T03:02:09Z"
},
"latestVesselInfo": true
},
{
"reference": "e33ca2a0-f922-49b1-813a-c2a48725986b",
"property": "registryInfo.vesselInfoReference",
"source": "registryInfo",
"matches": [
{
"property": "registryInfo.ssvid",
"value": "412440489"
}
],
"period": {
"dateFrom": "2015-01-17T22:02:30Z",
"dateTo": "2023-03-31T02:35:40Z"
},
"latestVesselInfo": true
}
]
}
]
}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment