Returns records for up to 100 vessels in a single call, supplied as an array of IMO numbers. Available from Professional tier upward. Quota is enforced: if a call would exceed the remaining balance, the full result set is still returned for that call, but subsequent calls return empty until quota resets.
Request
JSON
{
"query": "query GetVesselsByImos { vvdVesselsByImos(imos: [\"9281906\", \"9198082\", \"9973676\"]) { referenceData { identification { id { official { imo } } name { value } flag { code } } shipSize: metrics { shipSize { dwt { summer { actual } } } } } } }"
}
Response (truncated to first record)
JSON
{
"data": {
"vvdVesselsByImos": [
{
"referenceData": {
"identification": {
"id": { "official": { "imo": "9198082" } },
"name": { "value": "GLOBAL STAR" },
"flag": { "code": "TO" }
},
"shipSize": {
"shipSize": { "dwt": { "summer": { "actual": 104556 } } }
}
}
}
]
}
}
Full response returns one record per requested IMO, in this example three vessels: GLOBAL STAR, SEA DRACO, and AQUA RAY.
GraphQL form
GraphQL
query VvdVesselsByImos($imos: [String!]!) {
vvdVesselsByImos(imos: $imos)
}