API Reference

vesselsByMMSI

Match any Vessel's Maritime Mobile Service Identity (MMSI) to the vessel's IMOs and ID to overcome any MMSI duplications and focus on the true vessel of interest.

Query Schema

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

Arguments

NameTypeDescription
mmsiString!The Vessel MMSI number.

Returns

NameDescription
[VesselIntelligence!]!The vessel-related data.

VesselIntelligence Fields

NameTypeDescription
activitiesByType [Activity]Returns information on activities by type, timeframe, and location.

Parameters:
type: ActivityTypes!
timeRange: DateTimeRange
polygonTypes: [String!]
buildYearPositiveIntThe vessel build year.
callsignStringThe vessel transmitted call sign.
classStringThe vessel class.
complianceRiskComplianceVesselRisk!The risk of the ship not complying with sanction programs.
timeRangeClosedDateTimeRangeInputThe period for which the vessel information applies.
deadweightNonNegativeIntThe vessel deadweight.
draughtFloatLatest reported draft.
flagStringThe Vessel Flag.
grosstonnagePositiveIntThe molded volume of all the enclosed spaces in the ship converted to metric tons.
historicalNames[String]The vessel's historical names.
idObjectIdThe vessel unique Windward assigned ID.
imoPositiveIntThe vessel International Maritime Organization number.
insurerStringThe firm insuring the vessel.
lastPortCallActivityMost recent Port Call prior to the transmission.
lengthNonNegativeIntThe vessel length.
mmsiNonNegativeIntThe Vessel Maritime Mobile Service Identity number.
nameStringThe Vessel Name.
pscInspections[PSCInspection!]The Port State Control inspections performed on the vessel.
reportedPortReportedPortThe vessel transmitted destination.
riskAssessmentVesselRiskAssessment!The different risks the vessel is exposed to.
smugglingRiskSmugglingVesselRisk!The smuggling risks the vessel is exposed to.
statusStringThe 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.
subClassStringThe 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
      }
    }
    }
    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"
            }      
          ]
        },      
        "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": []
        }
      }
    ]
  }
}