# Vessels API

> Real-time vessel tracking and maritime intelligence REST API. Search vessels by name, IMO, or MMSI; track live AIS positions; monitor port congestion; assess fleet emissions (CII); and query arrivals, departures, and route history — all through a single authenticated endpoint.

## API

- Base URL: `https://vessels-api.com/api/V1`
- Authentication: `Authorization: Bearer YOUR_API_KEY` header on every request.
- [Postman collection](https://vessels-api.com/postman-collection.json): Importable collection for all endpoints.

## Documentation

- [Overview](https://vessels-api.com/docs#overview): Product overview, pricing, and quick-start.
- [Introduction](https://vessels-api.com/docs#introduction): API organization, versioning, and response format.
- [Authentication](https://vessels-api.com/docs#authentication): Authenticating requests with a Bearer API key.
- [Vessel search](https://vessels-api.com/docs#ep-search): GET `/vessels/search` — Search vessels by name, IMO, MMSI, or call sign.
- [Track vessel](https://vessels-api.com/docs#ep-track): GET `/vessels/track` — Real-time position and voyage data for a vessel.
- [Nearby vessels](https://vessels-api.com/docs#ep-nearby): GET `/vessels/nearby` — Vessels within a radius of a lat/lng coordinate.
- [Analytics](https://vessels-api.com/docs#ep-analytics): GET `/vessels/analytics` — Aggregate voyage and traffic analytics.
- [Fleet batch](https://vessels-api.com/docs#ep-fleet): POST `/vessels/fleet` — Bulk-query status for an entire fleet in one request.
- [CII / emissions](https://vessels-api.com/docs#ep-green): GET `/vessels/green` — Carbon Intensity Indicator and emissions data.
- [Port congestion](https://vessels-api.com/docs#ep-congestion): GET `/ports/congestion` — Live congestion index and wait-time estimates.
- [Port catalog](https://vessels-api.com/docs#ep-ports): GET `/ports` — Searchable catalog of world ports.
- [Port details](https://vessels-api.com/docs#ep-ports-data): GET `/ports/data` — Coordinates, type, and facilities for a port.
- [Expected arrivals](https://vessels-api.com/docs#ep-expected-arrivals): GET `/port/expected-arrivals` — Vessels expected at a port in a time window.
- [Port activity](https://vessels-api.com/docs#ep-activity): GET `/port/activity` — Recent arrivals and departures at a port.
- [Vessel info](https://vessels-api.com/docs#ep-info): GET `/vessel/info` — Static vessel particulars (flag, type, dimensions).
- [Vessel route](https://vessels-api.com/docs#ep-route): GET `/vessel/route` — Historical route and waypoints for a voyage.
- [Position (IMO)](https://vessels-api.com/docs#ep-position): GET `/vessel/position` — Current AIS position by IMO.
- [Position (MMSI)](https://vessels-api.com/docs#ep-mmsi-position): GET `/vessel/mmsi-position` — Current AIS position by MMSI number.
- [Vessels in port](https://vessels-api.com/docs#ep-vessel-port): GET `/vessel/port` — Vessels currently at or near a port.
- [Port visits (MMSI)](https://vessels-api.com/docs#ep-vessel-port-mmsi): GET `/vessel/port/mmsi` — Port visit history for a vessel by MMSI.
- [Error codes](https://vessels-api.com/docs#errors): HTTP error codes and troubleshooting.
- [Live AIS position](https://vessels-api.com/docs#introduction): GET `/vessel/live-position` — premium VesselFinder AIS feed (uses subscriber quota; not in public playground).

## Pages

- [Home](https://vessels-api.com/): Product overview, pricing, and live API playground.
- [Documentation](https://vessels-api.com/docs): Full API reference and examples.
- [Blog](https://vessels-api.com/blog): Articles on maritime data, AIS tracking, and fleet management.
- [Privacy Policy](https://vessels-api.com/privacy): Data handling and privacy practices.
- [Terms of Service](https://vessels-api.com/terms): Terms governing API usage.