---
title: "Get a vessel using the id"
method: GET
path: "/vessels/{id}"
tags: ["Vessels"]
---

# Get a vessel using the id

`GET /vessels/{id}`

Returns a vessel by id. <Note>`show_positions` is a paid feature. Please contact sales@terminal49.com.</Note>

## Response `200`

OK

- object
  - `data` Vessel
    - `id` string, uuid
    - `type` 'vessel'
    - `attributes` object
      - `name` string — The name of the ship or vessel
      - `imo` string, nullable — International Maritime Organization (IMO) number
      - `mmsi` string, nullable — Maritime Mobile Service Identity (MMSI)
      - `latitude` number, nullable — The current latitude position of the vessel
      - `longitude` number, nullable — The current longitude position of the vessel
      - `nautical_speed_knots` number, nullable — The current speed of the ship in knots (nautical miles per hour)
      - `navigational_heading_degrees` number, nullable — The current heading of the ship in degrees, where 0 is North, 90 is East, 180 is South, and 270 is West
      - `position_timestamp` string, nullable — The timestamp of when the ship's position was last recorded, in ISO 8601 date and time format
      - `positions` object[], nullable — An array of historical position data for the vessel. Only included if `show_positions` is true.
        - `latitude` number
        - `longitude` number
        - `heading` number, nullable
        - `timestamp` string, date-time
        - `estimated` boolean

## Other responses

- `403` — Forbidden - Feature not enabled

---

[API](https://skmtc.dev/terminal49/apis/terminal49-api-reference.md) · [All operations](https://skmtc.dev/terminal49/apis/terminal49-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/terminal49/terminal49-api-reference/revisions/998a27e39c03/schema)