---
title: "Retrieve a list of vessels from a name, a MMSI or an IMO."
method: GET
path: "/vessels"
tags: ["vessels"]
---

# Retrieve a list of vessels from a name, a MMSI or an IMO.

`GET /vessels`

## Request

- Base URL: `https://api.sinay.ai/ports-vessels/api/v1`
- URL: `https://api.sinay.ai/ports-vessels/api/v1/vessels`
- Auth: API key in header `API_KEY`
- TypeScript: <https://skmtc.dev/sinay/apis/ports-and-vessels-api/docs/vessels/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint is used to retrieve a list of vessels that can match your input.

It will return a list of of none/one/several vessels depending of the result of the search.

If there is no vessel that match your input the vessels list will be empty.

## Query parameters

- `vesselNameOrCode` string, required
- `numberOfResult` integer

## Response `200`

Successful Response

- VesselsResponse
  - `input` string
  - `vesselsList` Vessel[]
    - `name` string
    - `imo` string
    - `mmsi` string

## Other responses

- `400`: Validation Error
- `500`: An error occurend on server side

---

[API](https://skmtc.dev/sinay/apis/ports-and-vessels-api.md) - [All operations](https://skmtc.dev/sinay/apis/ports-and-vessels-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sinay/apis/ports-and-vessels-api/revisions/4bb8d55043bf?raw)