Skip to main content
GET
/
vessels-by-vessel-name
Vessel Details by Name
curl --request GET \
  --url https://datadocked.com/api/vessels_operations/vessels-by-vessel-name \
  --header 'x-api-key: <api-key>'
{
  "total": 123,
  "items": [
    {
      "name": "<string>",
      "mmsi": "<string>",
      "imo": "<string>",
      "country": "<string>",
      "type": "<string>",
      "callsign": "<string>",
      "typespecific": "<string>"
    }
  ]
}
Search for vessels by name and retrieve their IMO, MMSI, and basic specifications.
Credits: 1 credit per request

​
Name Formatting

Spaces in vessel names must be URL encoded as underscores (_).
Vessel NameQuery Parameter
DL ACACIAname=DL_ACACIA
EVER GIVENname=EVER_GIVEN
MSC OSCARname=MSC_OSCAR

​
Pagination

When multiple vessels share the same name, use the page_number parameter to paginate through results.

Authorizations

​
x-api-key
string
header
required

Your personal API key found in your profile dashboard at https://datadocked.com/dashboard/my_keys

Query Parameters

​
name
string
required

The name of the vessel you want to query. Spaces in vessel names must be URL encoded as _ (e.g., "DL ACACIA" becomes "DL_ACACIA").

​
page_number
integer
default:1

Page number for pagination when multiple vessels share the same name. Defaults to 1.

Response

Successful response with matching vessels

​
total
integer

Total matching vessels

​
items
object[]