---
title: "Vessel by IMO"
method: GET
path: "/api/v2/maritime/carriers/{imo}"
tags: ["Maritime"]
---

# Vessel by IMO

`GET /api/v2/maritime/carriers/{imo}`

One vessel by IMO number: identity, last-known position, and the matched Global Energy Monitor LNG carrier (when one exists). Position is LAST-KNOWN ONLY — no raw track. Returns 404 when no vessel identity exists for the IMO. Requires a plan with Maritime intelligence access (`can_use_maritime`) — the Corporate & Supply Chain plan and above.

Forward-accruing: position history begins at launch (June 2026). Terrestrial AIS only (no satellite).

## Path parameters

- `imo` string, required

## Response `200`

Vessel detail. `identity` carries imo, mmsi, name, ship_type, ship_type_code, call_sign, flag (ISO-3), length_m, width_m, draught_m, gem_id. `last_position` is the last-known { lat, lon, chokepoint, last_time, sog } or null. `gem_carrier` is the matched Global Energy Monitor LNG carrier { gem_id, name, imo_number } or null. Envelope: { success, imo, identity, last_position, gem_carrier }.

- object
  - `success` boolean
  - `imo` string
  - `identity` object
    - `imo` string
    - `mmsi` integer
    - `name` string
    - `ship_type` string
    - `ship_type_code` integer
    - `call_sign` string
    - `flag` string
    - `length_m` integer
    - `width_m` integer
    - `draught_m` number
    - `gem_id` string
  - `last_position` object
    - `lat` number
    - `lon` number
    - `chokepoint` string
    - `last_time` string
    - `sog` number
  - `gem_carrier` object
    - `gem_id` string
    - `name` string
    - `imo_number` string

## Other responses

- `400` — Invalid IMO (INVALID_IMO)
- `401` — Missing/invalid API key
- `403` — Plan required (PLAN_REQUIRED) — the caller's plan does not carry the required source entitlement.
- `404` — Vessel not found (NOT_FOUND)
- `500` — Server error

---

[API](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2.md) · [All operations](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gdeltcloud/gdelt-cloud-api-v2/revisions/01aaa6255180/schema)