# Search vessels (/docs/v3/vessels/search)



Vessels can be queried in two ways:

* Basic Search (`query` parameter): Performs a full-text search across all vessel fields for the provided term.
* Advanced Search (`where` parameter): Allows targeted filtering by specifying exact vessel fields to query against.

The results in this API are paginated. See [Pagination](/docs/v3/general-api-doc/pagination) for how `limit`, `offset`, and `nextOffset` work.

### Search Vessels Examples [#search-vessels-examples]

* [EXAMPLE 1](/docs/examples/vessels/vessels-example1) - Basic search - search any vessel by a keyword
* [EXAMPLE 2](/docs/examples/vessels/vessels-example2) - Advanced search - search any vessel by a keyword

### Search vessels Specifications [#search-vessels-specifications]

<OpenAPIPage document="apiv3" operations="[{ path: '/v3/vessels/search', method: 'get' }]" hasHead="false" />