Vessels
Search vessels
Find ships with an IMO number by name, IMO number, MMSI or call sign, and narrow them by flag, kind, size and the year they were built. A name matches in part, its words in any order, so ever giv finds EVER GIVEN; an IMO number, MMSI or call sign matches whole.
The best matches come first: the query exactly, then names starting with it, then the rest, the largest ships by gross tonnage first within each. Each result is a summary of the ship's particulars, as recorded; fetch those for the rest, or its position for where it is.
apiKeyAuthorizationBearer <token>An API key from the dashboard: a secret key (wk_sk_) from servers, or a publishable key (wk_pk_) from the origins listed on it. A workload can send its token in place of a secret key. See Authentication.
q?stringPart of a name, or an IMO number (7 digits), MMSI (9 digits) or call sign. Leave it out to list the ships that pass the filters, the largest first, with a secret key.
length <= 100flag?array<>Only ships under this flag, ISO 3166-1 alpha-2, e.g. LR. Repeat it for several.
category?array<>Only ships of this kind: passenger, cargo, tanker, service, fishing or other. Repeat it for several; leave it out for all of them.
min_deadweight?integerOnly ships of at least this deadweight, in tonnes.
0 <= valuemax_deadweight?integerOnly ships of at most this deadweight, in tonnes.
0 <= valuebuilt_from?integerOnly ships built in this year or later.
1800 <= value <= 2100built_to?integerOnly ships built in this year or earlier.
1800 <= value <= 2100limit?integerResults per page.
1 <= value <= 20050offset?integerHow many results to skip, for the next page.
0 <= value0A page of ships, best matches first. When offset + limit is less than total, there are more pages.
application/json- response
A page of the ships a search found.
results*array<>total*integerHow many ships match, across all pages.
limit*integeroffset*integercurl -X GET 'https://waykite.com/api/v1/vessels/search'{
"results": [
{
"imo": 9811000,
"mmsi": 636026627,
"name": "EVER GIVEN",
"call_sign": "A8AB9",
"flag": "LR",
"type": "Container ship",
"ship_category": "cargo",
"gross_tonnage": 219079,
"deadweight": 199692,
"year_built": 2018
}
],
"total": 1,
"limit": 50,
"offset": 0
}Port congestion GET
How long seagoing cargo ships and tankers waited for a berth at a port over the last 30 days, how long they stayed at it, and how many are waiting now. A ship's wait runs from when it stopped off the port for it, at an anchorage or drifting within 50 km, or at anchor in the port, to its first berth. Each spread is the median and the 75th percentile, `null` where too few calls berthed to tell. Coverage depends on the region: some ports have few ships heard near them, or none yet.
Nearby vessels GET
Find the ships last heard nearest a point, closest first, within 100 km. Distances are great-circle distances in kilometres, rounded to 0.1 km. Each ship is where it was last heard: a moving ship has its position kept every half hour or so, a ship at anchor or alongside every two hours. Coverage depends on the region, so a ship out of reach is missing rather than shown where it was days ago.