Skip to main content
POST
Find a US-documented vessel and its managing owner in the US Coast Guard vessel documentation file. Search by official number, IMO number or owner-name prefix. Covers US-documented vessels only: a foreign-flag vessel is reported as not found, with that reason. No street addresses are returned.

Authentication

Requires x402 payment in the payment-signature header.

Request Body

string
Coast Guard official number, six to eight digits.
string
IMO ship identification number.
string
Managing owner name prefix. 1 to 200 characters. Owner name must be valid Unicode without null characters.
integer
Maximum owner-search rows. From 1 to 50. Defaults to 25.

Response (200 OK)

Top-level envelope: success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status: completed
string
Always vessel_ownership
object
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always US Coast Guard.
string
public when the data comes from a public body, commercial otherwise
string
When the lookup was made, as an ISO 8601 UTC time
string | null
When the source says the fact was last updated, or null when the source gives no date

Result

Nested under data.result.
boolean
Found.
object[]
Vessels.
object
Observed.
string
Official number.
string | null
Imo. null when the source gives no value.
string | null
Mmsi. null when the source gives no value.
string | null
Name. null when the source gives no value.
string | null
Call sign. null when the source gives no value.
string | null
Flag. null when the source gives no value.
string | null
Type. null when the source gives no value.
boolean | null
Self propelled. null when the source gives no value.
number | null
Gross tonnage. null when the source gives no value.
number | null
Itc gross tonnage. null when the source gives no value.
integer | null
Year built. null when the source gives no value.
string | null
Hailing port. null when the source gives no value.
string | null
Hailing port state. null when the source gives no value.
string | null
Documentation status. null when the source gives no value.
string | null
Documentation issued. null when the source gives no value.
string | null
Documentation expires. null when the source gives no value.
object | null
The managing owner the Coast Guard records. null when the source gives no value.
string | null
Null for an individual: the Coast Guard withholds the name. null when the source gives no value.
string | null
The file’s organisation type, or “individual”. null when the source gives no value.
string | null
Country. null when the source gives no value.
string | null
When the party took the role, where the source gives it. null when the source gives no value.
string | null
The source’s identifier for the party. null when the source gives no value.
object | null
The ship manager, where a source gives one. null when the source gives no value.
string | null
Null for an individual: the Coast Guard withholds the name. null when the source gives no value.
string | null
The file’s organisation type, or “individual”. null when the source gives no value.
string | null
Country. null when the source gives no value.
string | null
When the party took the role, where the source gives it. null when the source gives no value.
string | null
The source’s identifier for the party. null when the source gives no value.
object | null
The party that runs the vessel, where a source gives one. null when the source gives no value.
string | null
Null for an individual: the Coast Guard withholds the name. null when the source gives no value.
string | null
The file’s organisation type, or “individual”. null when the source gives no value.
string | null
Country. null when the source gives no value.
string | null
When the party took the role, where the source gives it. null when the source gives no value.
string | null
The source’s identifier for the party. null when the source gives no value.
object | null
The ultimate owner, where a source gives one. null when the source gives no value.
string | null
Null for an individual: the Coast Guard withholds the name. null when the source gives no value.
string | null
The file’s organisation type, or “individual”. null when the source gives no value.
string | null
Country. null when the source gives no value.
string | null
When the party took the role, where the source gives it. null when the source gives no value.
string | null
The source’s identifier for the party. null when the source gives no value.
object
Derived.
integer
Total.
integer
Returned.
boolean
Truncated.
string | null
Why nothing matched, when coverage was available and nothing did. null when the source gives no value.
object
Coverage.
boolean
Available.
string | null
As of. null when the source gives no value.
string
Scope.
string | null
Reason. null when the source gives no value.
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers 200.

Notes

  • An empty result with coverage.available true means no match in the held monthly file, and absent_reason says why that happens; false means no evidence either way.
  • registered_owner is the managing owner the Coast Guard records; the file names organisations only, so an individual managing owner has a null name. company_id is the Coast Guard party identifier.
  • The Coast Guard file gives no manager, operator, beneficial_owner, since or mmsi: those fields are null until a ship register joins this tool.
  • Owner names match normalized uppercase text prefixes and find organisations only. Lists default to 25 rows, at most 50. Vessel type and documentation status keep the file’s own wording.
  • The file is published about monthly, early in the month it is named for, with vessel information through the day it was produced. coverage.as_of is that date for the held release; newer documentation is absent.
  • Results return inline. The finished job stays available at /v1/requests/{request_id}