Query Schema

type Query {
   vesselsByMMSI(mmsi: String!): [VesselIntelligence!]!
}

Arguments

Name	Type	Description
mmsi	String!	The Vessel MMSI number.

Returns

Name	Description
[VesselIntelligence!]!	The vessel-related data.

VesselIntelligence Fields

Name	Type	Description
activitiesByType	[Activity]	Returns information on activities by type, timeframe, and location. Parameters: type: ActivityTypes! timeRange: DateTimeRange polygonTypes: [String!]
buildYear	PositiveInt	The vessel build year.
callsign	String	The vessel transmitted call sign.
class	String	The vessel class.
complianceRisk	ComplianceVesselRisk!	The risk of the ship not complying with sanction programs.
dailyFuelConsumption	FuelConsumptionReport!	This service takes as input a date range and the IMO of a vessel (currently works for tankers only) and returns the fuel consumption computed at midnight UTC for the day that just ended. For example, date: ‘2022-01-02T00:00:00.000Z', 'totalFuelConsumption: 3.391’, that on January 1st, the vessel consumed 3.391 tons of fuel. A single run can go as far as 1 year back.
timeRange	ClosedDateTimeRangeInput	The period for which the vessel information applies.
deadweight	NonNegativeInt	The vessel deadweight.
draught	Float	Latest reported draft.
flag	String	The Vessel Flag.
grosstonnage	PositiveInt	The molded volume of all the enclosed spaces in the ship converted to metric tons.
historicalNames	[String]	The vessel's historical names.
id	ObjectId	The vessel unique Windward assigned ID.
imo	PositiveInt	The vessel International Maritime Organization number.
insurer	String	The firm insuring the vessel.
lastPortCall	Activity	Most recent Port Call prior to the transmission.
length	NonNegativeInt	The vessel length.
mmsi	NonNegativeInt	The Vessel Maritime Mobile Service Identity number.
name	String	The Vessel Name.
pscInspections	[PSCInspection!]	The Port State Control inspections performed on the vessel.
reportedPort	ReportedPort	The vessel transmitted destination.
riskAssessment	VesselRiskAssessment!	The different risks the vessel is exposed to.
smugglingRisk	SmugglingVesselRisk!	The smuggling risks the vessel is exposed to.
status	String	The vessel status; the available options are: "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.
subClass	String	The vessel sub-class.

Example Code

Sample Query

query VesselsByMMSI($mmsi: String!, $type: ActivityTypes!, $timeRange: ClosedDateTimeRangeInput) {
  vesselsByMMSI(mmsi: $mmsi) {
    id
    name
    imo
    mmsi
    class
    length
    flag
    status
    grosstonnage
    callsign
    subClass
    draught
    insurer
    historicalNames
    activitiesByType(type: $type) {
      duration
      id
      type
      startDate
      endDate
      previousPortId
      nextPortId
      vesselId
      formerMMSI
      endCoordinate
      startCoordinate
    }
    complianceRisk {
      imo
      level
      program
      isSanctioned
      riskySince
      buildingBlocks {
        name
        count
        program
        recentActivityStartDate
        level
      }
    }
    dailyFuelConsumption(timeRange: $timeRange) {
      successRate
      missingDays
      fuelConsumption {
        vesselId
        date
        totalFuelConsumption
        mainEngineFuelConsumption
        auxiliaryEngineFuelConsumption
        boilerFuelConsumption
      }
    }
    lastPortCall {
      id
      type
      startDate
      endDate
      previousPortId
      nextPortId
      vesselId
      formerMMSI
      endCoordinate
      startCoordinate
      duration
      description
    }
    pscInspections {
      inspectionId
      imo
      inspectionDate
      inspectionPort
      mou
      deficienciesNum
      inspectionResult
      inspectionType
      name
      callSign
      flag
      grossTonnage
    }
    reportedPort {
      ts
    }
    riskAssessment {
      iuuFishingRisk {
        id
        type
        vesselId
        score
        level
        createdAt
        riskIndicators {
          name
          score
          count
          createdAt
        }
      }
    }
    smugglingRisk {
      score
      level
      riskySince
      indicators {
        name
        risk
        count
      }
    }
  }
}

Variables

{
  "mmsi": "247080200",
  "type": "MEETING",
  "timeRange": {
     "from": "2021-01-01T00:00:00.011Z",
     "to": "2022-01-01T00:00:00.000Z"
   }
}

Response

{
  "data": {
    "vesselsByMMSI": [
      {
        "id": "5905c34f1cd6144c68ab7f31",
        "name": "GRANDE NAPOLI",
        "imo": 9247924,
        "mmsi": 247080200,
        "class": "Cargo",
        "length": 196,
        "flag": "Italy",
        "status": null,
        "grosstonnage": 37273,
        "callsign": "IBZE",
        "subClass": "Vehicles Carrier",
        "draught": 7.6,
        "insurer": "Standard P & I Club",
        "historicalNames": null,
        "activitiesByType": [
          {
            "duration": 1.8236111111111113,
            "id": "5743f5615aca592501a24dec",
            "type": "MEETING",
            "startDate": "2016-05-24T06:32:01.000Z",
            "endDate": "2016-05-24T08:21:26.000Z",
            "previousPortId": "5358fc77b68ca120a07db387",
            "nextPortId": "5358fc78b68ca120a07dbc61",
            "vesselId": "5905c34f1cd6144c68ab7f31",
            "formerMMSI": null,
            "endCoordinate": [
              16.02768,
              36.09719
            ],
            "startCoordinate": [
              15.43732,
              36.23133
            ]
          },
            .
            .
            .
          {
            "duration": 1,
            "id": "63a1fb48aaca9910e6c314f3",
            "type": "MEETING",
            "startDate": "2022-12-20T18:13:28.000Z",
            "endDate": "2022-12-20T19:13:28.000Z",
            "previousPortId": "5358fc78b68ca120a07dbacd",
            "nextPortId": null,
            "vesselId": "5905c34f1cd6144c68ab7f31",
            "formerMMSI": null,
            "endCoordinate": [
              103.88927,
              1.26073
            ],
            "startCoordinate": [
              103.88937,
              1.26073
            ]
          }
        ],
        "complianceRisk": {
          "imo": "9247924",
          "level": "Low",
          "program": null,
          "isSanctioned": false,
          "riskySince": null,
          "buildingBlocks": [
            {
              "name": "DARK_ACTIVITY",
              "count": null,
              "program": null,
              "recentActivityStartDate": null,
              "level": "Low"
            },
              .
              .
              .
            {
              "name": "FLAG",
              "count": null,
              "program": null,
              "recentActivityStartDate": null,
              "level": "Low"
            }      
          ]
        },
        "dailyFuelConsumption": {
          "successRate": "0/366",
          "missingDays": [
            "2021-01-01",
              .
              .
              .
            "2021-12-31"  
          ],
          "fuelConsumption": []
        },
        "lastPortCall": {
          "id": "6394906d6add3bb1acc15e95",
          "type": "PORT_CALL",
          "startDate": "2022-12-10T13:58:05.000Z",
          "endDate": "2022-12-11T09:55:26.000Z",
          "previousPortId": "5358fc78b68ca120a07dbace",
          "nextPortId": null,
          "vesselId": "5905c34f1cd6144c68ab7f31",
          "formerMMSI": null,
          "endCoordinate": [
            55.04268,
            25.01749
          ],
          "startCoordinate": [
            55.04122,
            25.0184
          ],
          "duration": 19.95583333333333,
          "description": null
        },
        "pscInspections": [
          {
            "inspectionId": "9247924_16 Jan 2022",
            "imo": "9247924",
            "inspectionDate": "2022-01-16T00:00:00.000Z",
            "inspectionPort": "Saudi Arabia",
            "mou": "RIYADH_MOU",
            "deficienciesNum": null,
            "inspectionResult": false,
            "inspectionType": null,
            "name": "GRANDE NAPOLI",
            "callSign": null,
            "flag": null,
            "grossTonnage":  
          },
             .
             .
             .
          {
            "inspectionId": "441379385",
            "imo": "9247924",
            "inspectionDate": "2015-07-17T00:00:00.000Z",
            "inspectionPort": "CADAR",
            "mou": "PARIS_MOU",
            "deficienciesNum": 0,
            "inspectionResult": false,
            "inspectionType": "INITIAL_INSPECTION",
            "name": "GRANDE NAPOLI",
            "callSign": "IBZE",
            "flag": "IT",
            "grossTonnage": "44408"
          }
        ],
        "reportedPort": {
          "ts": "2022-12-28T07:00:00.000Z"
        },
        "riskAssessment": {
          "iuuFishingRisk": null
        },
        "smugglingRisk": {
          "score": 0,
          "level": "Low",
          "riskySince": "2022-10-07T00:00:00.000Z",
          "indicators": []
        }
      }
    ]
  }
}