API Reference

SearchVesselByIdentifier

This function allows searching for vessels using a non-exact term. It will return up to 50 suggested vessels that their name, IMO, MMSI or historical name may be relevant to the searched term

Query Schema

type Query {
   SearchVesselsByIdentifier($identifier: String!, $limit: PositiveInt)
}

Arguments

NameTypeDescription
identifierString!Input search term
limitIntThe number of results that will be returned. The default number is 20, the max number is 50

Returns

NameDescription
SimplifiedVessel

SimplifiedVessel Fields

NameTypeDescription
callSignStringThe vessel transmitted call sign
vesselClassStringThe vessel class.
flagStringThe vessel flag.
historicalNames[String]The vessel's historical names.
historicalMmsis[[NonNegativeInt]]The vessel's historical MMSIs
idObjectIdThe vessel's unique Windward assigned ID.
imoPositiveIntThe vessel International Maritime Organization number.
mmsiNonNegativeIntThe Vessel Maritime Mobile Service Identity number.
++nameStringThe Vessel name.
statusStringThe vessel status:

"DEAD": The vessel was reported DEAD by an external source.

"NOT_AVAILABLE": The vessel was reported dead by an external source, but it did transmit in the past 30 days.
subClassStringThe vessel sub-class.
lastTransmitted DateTimeRangeThe last transmission received

Example Code

Sample Query

query SearchVesselsByIdentifier($identifier: String!, $limit: PositiveInt) {
    searchVesselsByIdentifier(identifier: $identifier, limit: $limit) {
        id
        name
    		imo
        mmsi
        flag
        lastTransmitted
        vesselClass
        vesselSubclass
        historicalNames
        historicalMmsis
        callsign
        status
    }
}

Variables

{
    "identifier": "atalantic",
    "limit": 2
}

Response


  "data": {
    "searchVesselsByIdentifier": [
      {
        "callsign": "LFKX",
        "flag": "Norway",
        "historicalMmsis": null,
        "historicalNames": [
          "ATLANTIC1"
        ],
        "id": "5dc4bfea83ff7c3741d728b8",
        "lastTransmitted": "2023-10-31T06:16:00.000Z",
        "name": "ATLANTIC",
        "mmsi": 257503000,
        "imo": 9849801,
        "status": null,
        "vesselClass": "Fishing",
        "vesselSubclass": null
      },
      {
        "callsign": "2CZE3",
        "flag": "UnitedKingdom",
        "historicalMmsis": null,
        "historicalNames": [
          "SY ATLANTIC"
        ],
        "id": "59067b8ca3ae7a110cef62e2",
        "lastTransmitted": "2023-10-31T06:38:33.000Z",
        "name": "ATLANTIC",
        "mmsi": 9563512,
        "imo": 9849801,
        "status": null,
        "vesselClass": "Pleasure",
        "vesselSubclass": null
      }
    ]
  }
}