Retrieve a vessel on one of your actively tracked shipments by its IMO number, including name, Terminal49 vessel ID, and current position. Requires Routing Data.
GET
/
vessels
/
{imo}
Get a vessel using the imo
curl --request GET \
--url https://api.terminal49.com/v2/vessels/{imo} \
--header 'Authorization: <api-key>'
This is a paid Routing Data endpoint. It returns only vessels on your account’s actively tracked shipments. See Vessel data access for the 401, 403, and 404 responses.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Terminal49","description":"Developer documentation for the Terminal49 API, DataSync, SDK, and MCP server for container tracking, shipment visibility, webhooks, and integrations.","colors":{"primary":"#1A9E52","light":"#1A9E52","dark":"#2ACD6C"},"logo":{"light":"https://mintcdn.com/terminal49/vf64v0nfd3Z9JQ4O/logos/light.svg?fit=max\u0026auto=format\u0026n=vf64v0nfd3Z9JQ4O\u0026q=85\u0026s=d4e213611d22dd79c263b9d1ffa46eea","dark":"https://mintcdn.com/terminal49/vf64v0nfd3Z9JQ4O/logos/dark.svg?fit=max\u0026auto=format\u0026n=vf64v0nfd3Z9JQ4O\u0026q=85\u0026s=4458f17b851e3549033b9bedb71fe3ba"},"favicon":"https://mintcdn.com/terminal49/tUOgDh5QtR_8-BBX/logos/favicon.svg?fit=max\u0026auto=format\u0026n=tUOgDh5QtR_8-BBX\u0026q=85\u0026s=cb027195e481e03988cbd56028fc2444","appearance":{"default":"light","strict":false},"navbar":{"links":[{"href":"https://www.terminal49.com/demo","label":"Talk To Us"}],"primary":{"type":"button","label":"Get Started","href":"https://app.terminal49.com/register"}},"footer":{"socials":{"twitter":"https://twitter.com/terminal49","linkedin":"https://www.linkedin.com/company/terminal49"},"links":[{"header":"Resources","items":[{"label":"Blog","href":"https://www.terminal49.com/blog"},{"label":"Contact","href":"https://www.terminal49.com/contact"},{"label":"Book a Demo","href":"https://www.terminal49.com/demo"}]},{"header":"Product","items":[{"label":"Sign in","href":"https://app.terminal49.com/"},{"label":"Start Free Trial","href":"https://app.terminal49.com/register"}]}]},"seo":{"metatags":{"og:type":"website","og:site_name":"Terminal49 Docs","twitter:card":"summary_large_image","twitter:site":"@terminal49"},"indexing":"all"},"integrations":{"gtm":{"tagId":"GTM-K8CDPJJG"},"posthog":{"apiKey":"phc_rBNVF6dUk5HU5m3pX9yZZWoehXoqZTCeKXFXCEoJzEyq","apiHost":"https://f.terminal49.com","sessionRecording":false}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"terminal49","hasAudioNarration":false,"actualSubdomain":"terminal49","customDomains":["terminal49.com"],"gitSource":{"type":"github","owner":"terminal49","repo":"api","deployBranch":"main","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae188d752eef3f54f99e2fc","collectionId":"9d709c63-2c29-4ff7-bf90-f0d14f66e364","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae188d752eef3f54f99e2fc"},"feedback":{"thumbs":true,"edits":true,"issues":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae188d752eef3f54f99e2fc","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"SDK Docs","count":109},{"language":"default","tag":"API Reference","count":105},{"language":"default","tag":"TypeScript API Reference","count":104},{"language":"default","tag":"Managers","count":42},{"language":"default","tag":"Developer Guide","count":35},{"language":"default","tag":"Models","count":21},{"language":"default","tag":"MCP","count":16},{"language":"default","tag":"Client","count":13},{"language":"default","tag":"Containers","count":11},{"language":"default","tag":"Documents","count":11}]},"assistantConfig":{"enableAskAiButton":true,"enableStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@terminal49.com","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"6921e1f7f5047ea275ad7af0","deploymentId":"660c368041a00f5c82bccd87","questionText":"How do I get the ETA?","status":"active","generatedBy":"manual","createdAt":"2025-11-22T16:16:55.122Z","updatedAt":"2025-11-22T16:16:55.122Z","__v":0},{"_id":"6921e1caf5047ea275ad7837","deploymentId":"660c368041a00f5c82bccd87","questionText":"How do I get a containers LFD (last free day)?","status":"active","generatedBy":"manual","createdAt":"2025-11-22T16:16:10.178Z","updatedAt":"2025-11-22T16:16:10.178Z","__v":0},{"_id":"6921e1b5f5047ea275ad7732","deploymentId":"660c368041a00f5c82bccd87","questionText":"How do I start tracking a bill of lading?","status":"active","generatedBy":"manual","createdAt":"2025-11-22T16:15:49.020Z","updatedAt":"2025-11-22T16:15:49.020Z","__v":0}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-docs/api-reference/vessels/get-a-vessel-using-the-imo","slug":"/api-docs/api-reference/vessels/get-a-vessel-using-the-imo","pageMetadata":{"title":"Get a vessel by IMO","description":"Retrieve a vessel on one of your actively tracked shipments by its IMO number, including name, Terminal49 vessel ID, and current position. Requires Routing Data.","og:title":"Get a Vessel by IMO Number | Terminal49 API","og:description":"Look up vessel details by IMO number using the Terminal49 API. Returns the vessel name, current position, flag, and associated shipment data.","openapi":"get /vessels/{imo}","href":"/api-docs/api-reference/vessels/get-a-vessel-using-the-imo"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retrieve a vessel on one of your actively tracked shipments by its IMO number, including name, Terminal49 vessel ID, and current position. Requires Routing Data.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,..._provideComponents(),...props.components},{Note}=_components;if(!Note)_missingMdxReference(`Note`,true);return _jsx(Note,{children:_jsxs(_components.p,{children:[`This is a paid Routing Data endpoint. It returns only vessels on your account’s actively tracked shipments. See `,_jsx(_components.a,{href:`/api-docs/useful-info/entitlements#vessel-data-access`,children:`Vessel data access`}),` for the `,_jsx(_components.code,{children:`401`}),`, `,_jsx(_components.code,{children:`403`}),`, and `,_jsx(_components.code,{children:`404`}),` responses.`]})})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get a vessel by IMO","description":"Retrieve a vessel on one of your actively tracked shipments by its IMO number, including name, Terminal49 vessel ID, and current position. Requires Routing Data.","og:title":"Get a Vessel by IMO Number | Terminal49 API","og:description":"Look up vessel details by IMO number using the Terminal49 API. Returns the vessel name, current position, flag, and associated shipment data.","openapi":"get /vessels/{imo}","href":"/api-docs/api-reference/vessels/get-a-vessel-using-the-imo"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/terminal49/bf5953d390eb98ad/segment.js"],"openApiReferenceData":{"operation":{"summary":"Get a vessel using the imo","tags":["Vessels"],"responses":{"200":"319c64e5-93e3-4070-b867-5b1ee34432a3","401":"c13a82cb-4129-423a-8fe7-b76e2ab3e8e8","403":"476de415-a6e3-4008-bf5d-806f02e5c467","404":"a532bf05-1462-4678-bda1-110ce0da005b"},"operationId":"get-vessels-imo","description":"Retrieve a vessel on one of your actively tracked shipments by its IMO number, including name, Terminal49 vessel ID, and current position. Requires Routing Data.","x-internal":true,"method":"get","type":"path","servers":["716b8bce-f12c-4964-b0ac-d1c057abd32a"],"security":["fa4ae7e9-ba7b-4434-9ac4-ccb8f8dc0459"],"path":"/vessels/{imo}","baseUrlOptions":["https://api.terminal49.com/v2"],"title":"Get a vessel using the imo","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ef9b0283-221e-4aa8-b033-0f46b690267f":{"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"},"name":"imo","in":"path","required":true},"b4544e61-0b51-44de-8631-f84c9241e69b":{"schema":{"type":"string","format":"date-time","example":"2025-05-20T00:00:00Z","isRequired":false,"description":"ISO 8601 timestamp to filter positions from. 7 days by default.","uniqueKey":"","typeLabel":"string\u003cdate-time>"},"name":"show_positions[from_timestamp]","in":"query","description":"ISO 8601 timestamp to filter positions from. 7 days by default.","required":false},"0d74ef10-3652-4f15-a91e-e58ef14d99f6":{"schema":{"type":"string","format":"date-time","example":"2025-05-24T00:00:00Z","isRequired":false,"description":"ISO 8601 timestamp to filter positions up to. Current time by default.","uniqueKey":"","typeLabel":"string\u003cdate-time>"},"name":"show_positions[to_timestamp]","in":"query","description":"ISO 8601 timestamp to filter positions up to. Current time by default.","required":false}},"responses":{"319c64e5-93e3-4070-b867-5b1ee34432a3":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"title":"vessel","type":"object","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"data.id","typeLabel":"string\u003cuuid>"},"type":{"type":"string","enum":["vessel"],"uniqueKey":"data.type","typeLabel":"enum\u003cstring>"},"attributes":{"type":"object","properties":{"name":{"type":"string","description":"The name of the ship or vessel","example":"Ever Given","uniqueKey":"data.attributes.name","typeLabel":"string"},"imo":{"oneOf":[{"type":"string","description":"International Maritime Organization (IMO) number","example":"9811000","uniqueKey":"data.attributes.imo.oneOf.0","typeLabel":"string"},{"type":"null","description":"International Maritime Organization (IMO) number","example":"9811000","uniqueKey":"data.attributes.imo.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.imo","typeLabel":"string | null"},"mmsi":{"oneOf":[{"type":"string","description":"Maritime Mobile Service Identity (MMSI)","example":"353136000","uniqueKey":"data.attributes.mmsi.oneOf.0","typeLabel":"string"},{"type":"null","description":"Maritime Mobile Service Identity (MMSI)","example":"353136000","uniqueKey":"data.attributes.mmsi.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.mmsi","typeLabel":"string | null"},"latitude":{"oneOf":[{"type":"number","description":"The current latitude position of the vessel","example":25.29845,"uniqueKey":"data.attributes.latitude.oneOf.0","typeLabel":"number"},{"type":"null","description":"The current latitude position of the vessel","example":25.29845,"uniqueKey":"data.attributes.latitude.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.latitude","typeLabel":"number | null"},"longitude":{"oneOf":[{"type":"number","description":"The current longitude position of the vessel","example":121.217,"uniqueKey":"data.attributes.longitude.oneOf.0","typeLabel":"number"},{"type":"null","description":"The current longitude position of the vessel","example":121.217,"uniqueKey":"data.attributes.longitude.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.longitude","typeLabel":"number | null"},"nautical_speed_knots":{"oneOf":[{"type":"number","description":"The current speed of the ship in knots (nautical miles per hour)","example":90,"uniqueKey":"data.attributes.nautical_speed_knots.oneOf.0","typeLabel":"number"},{"type":"null","description":"The current speed of the ship in knots (nautical miles per hour)","example":90,"uniqueKey":"data.attributes.nautical_speed_knots.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.nautical_speed_knots","typeLabel":"number | null"},"navigational_heading_degrees":{"oneOf":[{"type":"number","description":"The current heading of the ship in degrees, where 0 is North, 90 is East, 180 is South, and 270 is West","example":194,"uniqueKey":"data.attributes.navigational_heading_degrees.oneOf.0","typeLabel":"number"},{"type":"null","description":"The current heading of the ship in degrees, where 0 is North, 90 is East, 180 is South, and 270 is West","example":194,"uniqueKey":"data.attributes.navigational_heading_degrees.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.navigational_heading_degrees","typeLabel":"number | null"},"position_timestamp":{"oneOf":[{"type":"string","description":"The timestamp of when the ship's position was last recorded, in ISO 8601 date and time format","example":"2023-07-28T14:01:37Z","uniqueKey":"data.attributes.position_timestamp.oneOf.0","typeLabel":"string"},{"type":"null","description":"The timestamp of when the ship's position was last recorded, in ISO 8601 date and time format","example":"2023-07-28T14:01:37Z","uniqueKey":"data.attributes.position_timestamp.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.position_timestamp","typeLabel":"string | null"},"positions":{"oneOf":[{"type":"array","description":"An array of historical position data for the vessel. Only included if `show_positions` is true.","items":{"type":"object","properties":{"latitude":{"type":"number","example":1.477285,"uniqueKey":"data.attributes.positions.oneOf.0.items.[INDEX].latitude","typeLabel":"number"},"longitude":{"type":"number","example":104.535533333,"uniqueKey":"data.attributes.positions.oneOf.0.items.[INDEX].longitude","typeLabel":"number"},"heading":{"oneOf":[{"type":"number","example":51,"uniqueKey":"data.attributes.positions.oneOf.0.items.[INDEX].heading.oneOf.0","typeLabel":"number"},{"type":"null","example":51,"uniqueKey":"data.attributes.positions.oneOf.0.items.[INDEX].heading.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.positions.oneOf.0.items.[INDEX].heading","typeLabel":"number | null"},"timestamp":{"type":"string","format":"date-time","example":"2025-05-23T19:14:22Z","uniqueKey":"data.attributes.positions.oneOf.0.items.[INDEX].timestamp","typeLabel":"string\u003cdate-time>"},"estimated":{"type":"boolean","example":false,"uniqueKey":"data.attributes.positions.oneOf.0.items.[INDEX].estimated","typeLabel":"boolean"}},"uniqueKey":"data.attributes.positions.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.attributes.positions.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"An array of historical position data for the vessel. Only included if `show_positions` is true.","items":{"type":"object","properties":{"latitude":{"type":"number","example":1.477285},"longitude":{"type":"number","example":104.535533333},"heading":{"oneOf":[{"type":"number","example":51},{"type":"null","example":51}]},"timestamp":{"type":"string","format":"date-time","example":"2025-05-23T19:14:22Z"},"estimated":{"type":"boolean","example":false}}},"uniqueKey":"data.attributes.positions.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.positions","typeLabel":"object[] | null"}},"uniqueKey":"data.attributes","typeLabel":"object"}},"uniqueKey":"data","typeLabel":"vessel · object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","type":"vessel","attributes":{"name":"Ever Given","imo":"9811000","mmsi":"353136000","latitude":25.29845,"longitude":121.217,"nautical_speed_knots":90,"navigational_heading_degrees":194,"position_timestamp":"2023-07-28T14:01:37Z","positions":[{"latitude":1.477285,"longitude":104.535533333,"heading":51,"timestamp":"2025-05-23T19:14:22Z","estimated":false}]}}}}},"exampleType":"generated"}},"exampleType":"generated"},"c13a82cb-4129-423a-8fe7-b76e2ab3e8e8":{"description":"Unauthorized. The API token is missing or invalid, or the account may not perform this action.","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"title":"Error model","type":"object","properties":{"detail":{"oneOf":[{"type":"string","uniqueKey":"errors.items.[INDEX].detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"errors.items.[INDEX].detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"errors.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"errors.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.items.[INDEX].title","typeLabel":"string | null"},"source":{"oneOf":[{"type":"object","properties":{"pointer":{"oneOf":[{"type":"string","uniqueKey":"errors.items.[INDEX].source.oneOf.0.pointer.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"errors.items.[INDEX].source.oneOf.0.pointer.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.items.[INDEX].source.oneOf.0.pointer","typeLabel":"string | null"},"parameter":{"oneOf":[{"type":"string","uniqueKey":"errors.items.[INDEX].source.oneOf.0.parameter.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"errors.items.[INDEX].source.oneOf.0.parameter.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.items.[INDEX].source.oneOf.0.parameter","typeLabel":"string | null"}},"uniqueKey":"errors.items.[INDEX].source.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"pointer":{"oneOf":[{"type":"string"},{"type":"null"}]},"parameter":{"oneOf":[{"type":"string"},{"type":"null"}]}},"uniqueKey":"errors.items.[INDEX].source.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.items.[INDEX].source","typeLabel":"object | null"},"code":{"oneOf":[{"type":"string","uniqueKey":"errors.items.[INDEX].code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"errors.items.[INDEX].code.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string | null"},"status":{"oneOf":[{"type":"string","uniqueKey":"errors.items.[INDEX].status.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"errors.items.[INDEX].status.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.items.[INDEX].status","typeLabel":"string | null"},"meta":{"oneOf":[{"type":"object","additionalProperties":true,"uniqueKey":"errors.items.[INDEX].meta.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"uniqueKey":"errors.items.[INDEX].meta.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.items.[INDEX].meta","typeLabel":"object | null"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"Error model · object"},"uniqueKey":"errors","typeLabel":"Error model · object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"errors":[{"detail":"You are not allowed to perform this action"}]},"examples":{"Example":{"title":"Example","value":{"errors":[{"detail":"You are not allowed to perform this action"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"476de415-a6e3-4008-bf5d-806f02e5c467":{"description":"Forbidden - Routing data feature is not enabled for this account","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string","example":"403","uniqueKey":"errors.items.[INDEX].status","typeLabel":"string"},"source":{"oneOf":[{"type":"object","uniqueKey":"errors.items.[INDEX].source.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"errors.items.[INDEX].source.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.items.[INDEX].source","typeLabel":"object | null"},"title":{"type":"string","example":"Forbidden","uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"},"detail":{"type":"string","example":"Routing data feature is not enabled for this account","uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"status":"403","source":{},"title":"Forbidden","detail":"Routing data feature is not enabled for this account"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"a532bf05-1462-4678-bda1-110ce0da005b":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"title":"Error model","type":"object","properties":{"detail":{"oneOf":[{"type":"string","uniqueKey":"errors.items.[INDEX].detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"errors.items.[INDEX].detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"errors.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"errors.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.items.[INDEX].title","typeLabel":"string | null"},"source":{"oneOf":[{"type":"object","properties":{"pointer":{"oneOf":[{"type":"string","uniqueKey":"errors.items.[INDEX].source.oneOf.0.pointer.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"errors.items.[INDEX].source.oneOf.0.pointer.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.items.[INDEX].source.oneOf.0.pointer","typeLabel":"string | null"},"parameter":{"oneOf":[{"type":"string","uniqueKey":"errors.items.[INDEX].source.oneOf.0.parameter.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"errors.items.[INDEX].source.oneOf.0.parameter.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.items.[INDEX].source.oneOf.0.parameter","typeLabel":"string | null"}},"uniqueKey":"errors.items.[INDEX].source.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"pointer":{"oneOf":[{"type":"string"},{"type":"null"}]},"parameter":{"oneOf":[{"type":"string"},{"type":"null"}]}},"uniqueKey":"errors.items.[INDEX].source.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.items.[INDEX].source","typeLabel":"object | null"},"code":{"oneOf":[{"type":"string","uniqueKey":"errors.items.[INDEX].code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"errors.items.[INDEX].code.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string | null"},"status":{"oneOf":[{"type":"string","uniqueKey":"errors.items.[INDEX].status.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"errors.items.[INDEX].status.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.items.[INDEX].status","typeLabel":"string | null"},"meta":{"oneOf":[{"type":"object","additionalProperties":true,"uniqueKey":"errors.items.[INDEX].meta.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"uniqueKey":"errors.items.[INDEX].meta.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.items.[INDEX].meta","typeLabel":"object | null"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"Error model · object"},"uniqueKey":"errors","typeLabel":"Error model · object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"errors":[{"status":"404","title":"Not Found"}]},"examples":{"Example":{"title":"Example","value":{"errors":[{"status":"404","title":"Not Found"}]}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"fa4ae7e9-ba7b-4434-9ac4-ccb8f8dc0459":{"authorization":{"name":"Authorization","type":"apiKey","in":"header","description":"Use a Terminal49 API key in the `Authorization` header with the `Token` prefix.\n\n`Authorization: Token YOUR_API_KEY`","scopes":[],"schemeName":"authorization"}}},"servers":{"716b8bce-f12c-4964-b0ac-d1c057abd32a":{"url":"https://api.terminal49.com/v2","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"name":"Authorization","type":"apiKey","in":"header","description":"Use a Terminal49 API key in the `Authorization` header with the `Token` prefix.\n\n`Authorization: Token YOUR_API_KEY`","scopes":[],"schemeName":"authorization"},"schema":{"title":"Authorization","type":"string","description":"Use a Terminal49 API key in the `Authorization` header with the `Token` prefix.\n\n`Authorization: Token YOUR_API_KEY`","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"authorization","name":"Authorization"}],"title":"authorization"}]},"originalFileLocation":"openapi.json"},"subdomain":"terminal49","siteName":"Terminal49","title":"Get a Vessel by IMO Number | Terminal49 API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-19T20:45:44.056Z","originalFileLocation":"api-docs/api-reference/vessels/get-a-vessel-using-the-imo.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieve a vessel on one of your actively tracked shipments by its IMO number, including name, Terminal49 vessel ID, and current position. Requires Routing Data.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Terminal49\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/terminal49/_9u2Tikn6cczLICg/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/terminal49/_9u2Tikn6cczLICg/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/terminal49/_9u2Tikn6cczLICg/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/terminal49/_9u2Tikn6cczLICg/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/terminal49/_9u2Tikn6cczLICg/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/terminal49/_9u2Tikn6cczLICg/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/terminal49/_9u2Tikn6cczLICg/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/terminal49/_9u2Tikn6cczLICg/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/terminal49/_9u2Tikn6cczLICg/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a Vessel by IMO Number | Terminal49 API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Look up vessel details by IMO number using the Terminal49 API. Returns the vessel name, current position, flag, and associated shipment data.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Terminal49 Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://terminal49.com/docs/api-docs/api-reference/vessels/get-a-vessel-using-the-imo\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://terminal49.mintlify.app/_mintlify/api/og/v2?division=Vessels\u0026amp;title=Get+a+vessel+by+IMO\u0026amp;description=Retrieve+a+vessel+on+one+of+your+actively+tracked+shipments+by+its+IMO+number%2C+including+name%2C+Terminal49+vessel+ID%2C+and+current+position.+Requires+Routing+Data\u0026amp;theme=7be098b423a76a1dd960de64\u0026amp;signature=bacb969065fb77e8388bbaa95a2779f993ae8265570a7b8df87ab911ecf80b52\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get a Vessel by IMO Number | Terminal49 API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Look up vessel details by IMO number using the Terminal49 API. Returns the vessel name, current position, flag, and associated shipment data.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://terminal49.mintlify.app/_mintlify/api/og/v2?division=Vessels\u0026amp;title=Get+a+vessel+by+IMO\u0026amp;description=Retrieve+a+vessel+on+one+of+your+actively+tracked+shipments+by+its+IMO+number%2C+including+name%2C+Terminal49+vessel+ID%2C+and+current+position.+Requires+Routing+Data\u0026amp;theme=7be098b423a76a1dd960de64\u0026amp;signature=bacb969065fb77e8388bbaa95a2779f993ae8265570a7b8df87ab911ecf80b52\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/terminal49/_9u2Tikn6cczLICg/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Terminal49\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1A9E52\">\u003clink data-mint-head rel=\"canonical\" href=\"https://terminal49.com/docs/api-docs/api-reference/vessels/get-a-vessel-using-the-imo\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-docs/api-reference/vessels/get-a-vessel-using-the-imo.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://terminal49.com/#organization\",\"name\":\"Terminal49\",\"url\":\"https://terminal49.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/terminal49/vf64v0nfd3Z9JQ4O/logos/light.svg?fit=max\u0026auto=format\u0026n=vf64v0nfd3Z9JQ4O\u0026q=85\u0026s=d4e213611d22dd79c263b9d1ffa46eea\"}},{\"@type\":\"WebSite\",\"@id\":\"https://terminal49.com/docs#website\",\"name\":\"Terminal49\",\"url\":\"https://terminal49.com/docs\",\"publisher\":{\"@id\":\"https://terminal49.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://terminal49.com/docs/api-docs/api-reference/vessels/get-a-vessel-using-the-imo#webpage\",\"url\":\"https://terminal49.com/docs/api-docs/api-reference/vessels/get-a-vessel-using-the-imo\",\"name\":\"Get a vessel by IMO\",\"description\":\"Retrieve a vessel on one of your actively tracked shipments by its IMO number, including name, Terminal49 vessel ID, and current position. Requires Routing Data.\",\"dateModified\":\"2026-10-19T20:45:44.056Z\",\"isPartOf\":{\"@id\":\"https://terminal49.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://terminal49.com/docs/api-docs/api-reference/vessels/get-a-vessel-using-the-imo#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://terminal49.com/docs/api-docs/api-reference/vessels/get-a-vessel-using-the-imo#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Vessels\",\"item\":\"https://terminal49.com/docs/api-docs/api-reference/vessels/get-a-vessel-using-the-id\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a vessel by IMO\",\"item\":\"https://terminal49.com/docs/api-docs/api-reference/vessels/get-a-vessel-using-the-imo\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://terminal49.com/docs/api-docs/api-reference/vessels/get-a-vessel-using-the-imo#apireference\",\"headline\":\"Get a vessel by IMO\",\"name\":\"Get a vessel by IMO\",\"description\":\"Retrieve a vessel on one of your actively tracked shipments by its IMO number, including name, Terminal49 vessel ID, and current position. Requires Routing Data.\",\"url\":\"https://terminal49.com/docs/api-docs/api-reference/vessels/get-a-vessel-using-the-imo\",\"mainEntityOfPage\":{\"@id\":\"https://terminal49.com/docs/api-docs/api-reference/vessels/get-a-vessel-using-the-imo#webpage\"},\"dateModified\":\"2026-10-19T20:45:44.056Z\",\"publisher\":{\"@id\":\"https://terminal49.com/#organization\"},\"isPartOf\":{\"@id\":\"https://terminal49.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Terminal49\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Terminal49","nav":{"global":{},"tabs":[{"tab":"Developer Guide","icon":"book","pages":[{"title":"Developer Guide","href":"/home"}]},{"tab":"API Reference","icon":"code","groups":[{"group":" ","pages":[{"title":"Terminal49 API Reference: Ocean Container Tracking","sidebarTitle":"Introduction","href":"/api-docs/api-reference/introduction"},{"title":"Shipment and container list filter reference","sidebarTitle":"List filters","href":"/api-docs/api-reference/list-filters"}]},{"group":"Tracking Requests","icon":"search","pages":[{"title":"List tracking requests","openapi":"get /tracking_requests","href":"/api-docs/api-reference/tracking-requests/list-tracking-requests"},{"title":"Create a tracking request","openapi":"post /tracking_requests","href":"/api-docs/api-reference/tracking-requests/create-a-tracking-request"},{"title":"Get a tracking request","openapi":"get /tracking_requests/{id}","href":"/api-docs/api-reference/tracking-requests/get-a-single-tracking-request"},{"title":"Edit a tracking request","openapi":"patch /tracking_requests/{id}","href":"/api-docs/api-reference/tracking-requests/edit-a-tracking-request"},{"title":"Cancel a tracking request","openapi":"patch /tracking_requests/{id}/cancel","href":"/api-docs/api-reference/tracking-requests/cancel-a-tracking-request"},{"title":"Infer Tracking Number (Beta)","sidebarTitle":"Infer Tracking Number 🆕","openapi":"post /tracking_requests/infer_number","href":"/api-docs/api-reference/tracking-requests/auto-detect-carrier"},{"title":"List tracking request custom fields","openapi":"get /tracking_requests/{tracking_request_id}/custom_fields","href":"/api-docs/api-reference/tracking-requests/list-tracking-request-custom-fields"},{"title":"Create tracking request custom field","openapi":"post /tracking_requests/{tracking_request_id}/custom_fields","href":"/api-docs/api-reference/tracking-requests/create-tracking-request-custom-field"},{"title":"Update tracking request custom field","openapi":"patch /tracking_requests/{tracking_request_id}/custom_fields/{api_slug}","href":"/api-docs/api-reference/tracking-requests/update-tracking-request-custom-field"},{"title":"Delete tracking request custom field","openapi":"delete /tracking_requests/{tracking_request_id}/custom_fields/{api_slug}","href":"/api-docs/api-reference/tracking-requests/delete-tracking-request-custom-field"}]},{"group":"Shipments","icon":"ship","pages":[{"title":"List shipments","openapi":"get /shipments","href":"/api-docs/api-reference/shipments/list-shipments"},{"title":"Get a shipment","openapi":"get /shipments/{id}","href":"/api-docs/api-reference/shipments/get-a-shipment"},{"title":"Edit a shipment","openapi":"patch /shipments/{id}","href":"/api-docs/api-reference/shipments/edit-a-shipment"},{"title":"List shipment custom fields","openapi":"get /shipments/{shipment_id}/custom_fields","href":"/api-docs/api-reference/shipments/list-shipment-custom-fields"},{"title":"Create shipment custom field","openapi":"post /shipments/{shipment_id}/custom_fields","href":"/api-docs/api-reference/shipments/create-shipment-custom-field"},{"title":"Update shipment custom field","openapi":"patch /shipments/{shipment_id}/custom_fields/{api_slug}","href":"/api-docs/api-reference/shipments/update-shipment-custom-field"},{"title":"Delete shipment custom field","openapi":"delete /shipments/{shipment_id}/custom_fields/{api_slug}","href":"/api-docs/api-reference/shipments/delete-shipment-custom-field"},{"title":"Stop tracking a shipment","openapi":"patch /shipments/{id}/stop_tracking","href":"/api-docs/api-reference/shipments/stop-tracking-shipment"},{"title":"Resume tracking a shipment","openapi":"patch /shipments/{id}/resume_tracking","href":"/api-docs/api-reference/shipments/resume-tracking-shipment"}]},{"group":"Containers","icon":"warehouse","pages":[{"title":"List containers","openapi":"get /containers","href":"/api-docs/api-reference/containers/list-containers"},{"title":"Edit a container","openapi":"patch /containers/{id}","href":"/api-docs/api-reference/containers/edit-a-container"},{"title":"Get a container","openapi":"get /containers/{id}","href":"/api-docs/api-reference/containers/get-a-container"},{"title":"List container custom fields","openapi":"get /containers/{container_id}/custom_fields","href":"/api-docs/api-reference/containers/list-container-custom-fields"},{"title":"Create container custom field","openapi":"post /containers/{container_id}/custom_fields","href":"/api-docs/api-reference/containers/create-container-custom-field"},{"title":"Update container custom field","openapi":"patch /containers/{container_id}/custom_fields/{api_slug}","href":"/api-docs/api-reference/containers/update-container-custom-field"},{"title":"Delete container custom field","openapi":"delete /containers/{container_id}/custom_fields/{api_slug}","href":"/api-docs/api-reference/containers/delete-container-custom-field"},{"title":"Refresh a container","openapi":"patch /containers/{id}/refresh","href":"/api-docs/api-reference/containers/refresh-container"},{"title":"Get container map GeoJSON","openapi":"get /containers/{id}/map_geojson","href":"/api-docs/api-reference/containers/get-container-map-geojson"},{"title":"Get a container's raw events","openapi":"get /containers/{id}/raw_events","href":"/api-docs/api-reference/containers/get-a-containers-raw-events"},{"title":"Get a container's transport events","openapi":"get /containers/{id}/transport_events","href":"/api-docs/api-reference/containers/get-a-containers-transport-events"}]},{"group":"Documents","icon":"file","pages":[{"title":"List documents","openapi":"get /documents","href":"/api-docs/api-reference/documents/list-documents"},{"title":"Upload a document","openapi":"post /documents","href":"/api-docs/api-reference/documents/upload-a-document"},{"title":"Get a document","openapi":"get /documents/{id}","href":"/api-docs/api-reference/documents/get-a-document"},{"title":"Edit a document","openapi":"patch /documents/{id}","href":"/api-docs/api-reference/documents/edit-a-document"},{"title":"Delete a document","openapi":"delete /documents/{id}","href":"/api-docs/api-reference/documents/delete-a-document"},{"title":"List document types","openapi":"get /documents/types","href":"/api-docs/api-reference/documents/list-document-types"},{"title":"Get a document download URL","openapi":"get /documents/{id}/download_url","href":"/api-docs/api-reference/documents/get-a-document-download-url"},{"title":"Re-extract a document","openapi":"post /documents/{id}/reextract","href":"/api-docs/api-reference/documents/re-extract-a-document"},{"title":"Re-classify a document","openapi":"post /documents/{id}/reclassify","href":"/api-docs/api-reference/documents/re-classify-a-document"},{"title":"Re-link a document","openapi":"post /documents/{id}/relink","href":"/api-docs/api-reference/documents/re-link-a-document"},{"title":"Rotate a document","openapi":"post /documents/{id}/rotate","href":"/api-docs/api-reference/documents/rotate-a-document"}]},{"group":"Email Submissions","icon":"envelope","pages":[{"title":"List email submissions","openapi":"get /email_submissions","href":"/api-docs/api-reference/email-submissions/list-email-submissions"},{"title":"Get an email submission","openapi":"get /email_submissions/{id}","href":"/api-docs/api-reference/email-submissions/get-an-email-submission"}]},{"group":"Document Schemas","icon":"brackets-curly","pages":[{"title":"Get a document schema","openapi":"get /document_schemas/{id}","href":"/api-docs/api-reference/document-schemas/get-a-document-schema"}]},{"group":"Document Representations","icon":"binary","pages":[{"title":"Document representations resource","href":"/api-docs/api-reference/document-representations/document-representations-resource"}]},{"group":"Search","icon":"magnifying-glass","pages":[{"title":"Search","openapi":"get /search","href":"/api-docs/api-reference/search/search"}]},{"group":"Webhooks","icon":"webhook","pages":[{"title":"Get a single webhook","openapi":"get /webhooks/{id}","href":"/api-docs/api-reference/webhooks/get-single-webhook"},{"title":"Delete a webhook","openapi":"delete /webhooks/{id}","href":"/api-docs/api-reference/webhooks/delete-a-webhook"},{"title":"Edit a webhook","openapi":"patch /webhooks/{id}","href":"/api-docs/api-reference/webhooks/edit-a-webhook"},{"title":"List webhooks","openapi":"get /webhooks","href":"/api-docs/api-reference/webhooks/list-webhooks"},{"title":"List webhook events","openapi":"get /webhooks/events","href":"/api-docs/api-reference/webhooks/list-webhook-events"},{"title":"Create a webhook","openapi":"post /webhooks","href":"/api-docs/api-reference/webhooks/create-a-webhook"},{"title":"Trigger a webhook test delivery","openapi":"post /webhooks/trigger","href":"/api-docs/api-reference/webhooks/trigger-a-webhook"},{"title":"List webhook IPs","openapi":"get /webhooks/ips","href":"/api-docs/api-reference/webhooks/list-webhook-ips"}]},{"group":"Webhook Notifications","icon":"bell","pages":[{"title":"Get a single webhook notification","openapi":"get /webhook_notifications/{id}","href":"/api-docs/api-reference/webhook-notifications/get-a-single-webhook-notification"},{"title":"List webhook notifications","openapi":"get /webhook_notifications","href":"/api-docs/api-reference/webhook-notifications/list-webhook-notifications"},{"title":"Get webhook notification payload examples","openapi":"get /webhook_notifications/examples","href":"/api-docs/api-reference/webhook-notifications/get-webhook-notification-payload-examples"}]},{"group":"Custom Field Definitions","pages":[{"title":"List account custom field definitions","openapi":"get /accounts/{account_id}/custom_field_definitions","href":"/api-docs/api-reference/custom-fields/list-account-custom-field-definitions"},{"title":"Create an account custom field definition","openapi":"post /accounts/{account_id}/custom_field_definitions","href":"/api-docs/api-reference/custom-fields/create-account-custom-field-definition"},{"title":"List custom field definition templates","openapi":"get /custom_field_definitions","href":"/api-docs/api-reference/custom-fields/list-custom-field-definitions"},{"title":"Get a custom field definition","openapi":"get /custom_field_definitions/{id}","href":"/api-docs/api-reference/custom-fields/get-a-custom-field-definition"},{"title":"Create a custom field definition template","openapi":"post /custom_field_definitions","href":"/api-docs/api-reference/custom-fields/create-a-custom-field-definition"},{"title":"Update a custom field definition","openapi":"patch /custom_field_definitions/{id}","href":"/api-docs/api-reference/custom-fields/update-a-custom-field-definition"},{"title":"Delete a custom field definition","openapi":"delete /custom_field_definitions/{id}","href":"/api-docs/api-reference/custom-fields/delete-a-custom-field-definition"}]},{"group":"Custom Field Options","pages":[{"title":"List custom field options","openapi":"get /custom_field_definitions/{definition_id}/options","href":"/api-docs/api-reference/custom-fields/list-custom-field-options"},{"title":"Get a custom field option","openapi":"get /custom_field_definitions/{definition_id}/options/{option_id}","href":"/api-docs/api-reference/custom-fields/get-a-custom-field-option"},{"title":"Create a custom field option","openapi":"post /custom_field_definitions/{definition_id}/options","href":"/api-docs/api-reference/custom-fields/create-a-custom-field-option"},{"title":"Update a custom field option","openapi":"patch /custom_field_definitions/{definition_id}/options/{option_id}","href":"/api-docs/api-reference/custom-fields/update-a-custom-field-option"},{"title":"Delete a custom field option","openapi":"delete /custom_field_definitions/{definition_id}/options/{option_id}","href":"/api-docs/api-reference/custom-fields/delete-a-custom-field-option"}]},{"group":"Custom Fields","pages":[{"title":"List custom fields","openapi":"get /custom_fields","href":"/api-docs/api-reference/custom-fields/list-custom-fields"},{"title":"Get a custom field","openapi":"get /custom_fields/{id}","href":"/api-docs/api-reference/custom-fields/get-a-custom-field"},{"title":"Create a custom field","openapi":"post /custom_fields","href":"/api-docs/api-reference/custom-fields/create-a-custom-field"},{"title":"Update a custom field","openapi":"patch /custom_fields/{id}","href":"/api-docs/api-reference/custom-fields/update-a-custom-field"},{"title":"Delete a custom field","openapi":"delete /custom_fields/{id}","href":"/api-docs/api-reference/custom-fields/delete-a-custom-field"}]},{"group":"Account","icon":"id-badge","pages":[{"title":"Get the current credential","openapi":"get /me","href":"/api-docs/api-reference/account/get-the-current-credential"}]},{"group":"Trade Intelligence","icon":"chart-line","pages":[{"title":"Get trade intelligence coverage","openapi":"get /trade_intel/meta","href":"/api-docs/api-reference/trade-intelligence/get-trade-intelligence-coverage"},{"title":"Search importers","openapi":"post /trade_intel/companies/search","href":"/api-docs/api-reference/trade-intelligence/search-importers"},{"title":"Get an importer profile","openapi":"post /trade_intel/companies/profile","href":"/api-docs/api-reference/trade-intelligence/get-an-importer-profile"},{"title":"Search commodities","openapi":"post /trade_intel/commodities/search","href":"/api-docs/api-reference/trade-intelligence/search-commodities"},{"title":"Rank importers","openapi":"post /trade_intel/importers/top","href":"/api-docs/api-reference/trade-intelligence/rank-importers"},{"title":"Get import trends","openapi":"post /trade_intel/trends","href":"/api-docs/api-reference/trade-intelligence/get-import-trends"},{"title":"Get an import breakdown","openapi":"post /trade_intel/breakdown","href":"/api-docs/api-reference/trade-intelligence/get-an-import-breakdown"},{"title":"Look up a container's import record","openapi":"post /trade_intel/containers/lookup","href":"/api-docs/api-reference/trade-intelligence/look-up-a-containers-import-record"},{"title":"Look up a bill of lading","openapi":"post /trade_intel/bills_of_lading/lookup","href":"/api-docs/api-reference/trade-intelligence/look-up-a-bill-of-lading"}]},{"group":"Shipping Lines","icon":"ship","pages":[{"title":"List shipping lines","openapi":"get /shipping_lines","href":"/api-docs/api-reference/shipping-lines/shipping-lines"},{"title":"Get a single shipping line","openapi":"get /shipping_lines/{id}","href":"/api-docs/api-reference/shipping-lines/get-a-single-shipping-line"}]},{"group":"Metro Areas","icon":"map-pin","pages":[{"title":"Get a metro area","openapi":"get /metro_areas/{id}","href":"/api-docs/api-reference/metro-areas/get-a-metro-area-using-the-unlocode-or-the-id"}]},{"group":"Ports","icon":"anchor","pages":[{"title":"Get a port","openapi":"get /ports/{id}","href":"/api-docs/api-reference/ports/get-a-port-using-the-locode-or-the-id"}]},{"group":"Vessels","icon":"sailboat","pages":[{"title":"Get a vessel by ID","description":"Retrieve a vessel on one of your actively tracked shipments by its Terminal49 vessel ID, including name, IMO number, and current position. Requires Routing Data.","openapi":"get /vessels/{id}","href":"/api-docs/api-reference/vessels/get-a-vessel-using-the-id"},{"title":"Get a vessel by IMO","openapi":"get /vessels/{imo}","href":"/api-docs/api-reference/vessels/get-a-vessel-using-the-imo"},{"title":"Get vessel future positions","description":"Retrieve a vessel's estimated future route between two ports from the Terminal49 API, returning a sequence of positions spaced one minute apart.","openapi":"get /vessels/{id}/future_positions","href":"/api-docs/api-reference/vessels/get-vessel-future-positions"},{"title":"Get vessel future positions from coordinates","openapi":"get /vessels/{id}/future_positions_with_coordinates","href":"/api-docs/api-reference/vessels/get-vessel-future-positions-with-coordinates"}]},{"group":"Terminals","icon":"warehouse","pages":[{"title":"Get a terminal","openapi":"get /terminals/{id}","href":"/api-docs/api-reference/terminals/get-a-terminal-using-the-id"}]},{"group":"Parties","icon":"users","pages":[{"title":"List parties","openapi":"get /parties","href":"/api-docs/api-reference/parties/list-parties"},{"title":"Create a party","openapi":"post /parties","href":"/api-docs/api-reference/parties/create-a-party"},{"title":"Get a party","openapi":"get /parties/{id}","href":"/api-docs/api-reference/parties/get-a-party"},{"title":"Edit a party","openapi":"patch /parties/{id}","href":"/api-docs/api-reference/parties/edit-a-party"}]},{"group":"Party Roles","icon":"user-tag","pages":[{"title":"List shipment party roles","openapi":"get /shipments/{shipment_id}/party_roles","href":"/api-docs/api-reference/party-roles/list-shipment-party-roles"},{"title":"Assign a shipment party role","openapi":"post /shipments/{shipment_id}/party_roles","href":"/api-docs/api-reference/party-roles/assign-a-shipment-party-role"},{"title":"Remove a shipment party role","openapi":"delete /shipments/{shipment_id}/party_roles/{id}","href":"/api-docs/api-reference/party-roles/remove-a-shipment-party-role"},{"title":"List container party roles","openapi":"get /containers/{container_id}/party_roles","href":"/api-docs/api-reference/party-roles/list-container-party-roles"},{"title":"Assign a container party role","openapi":"post /containers/{container_id}/party_roles","href":"/api-docs/api-reference/party-roles/assign-a-container-party-role"},{"title":"Remove a container party role","openapi":"delete /containers/{container_id}/party_roles/{id}","href":"/api-docs/api-reference/party-roles/remove-a-container-party-role"}]}]},{"tab":"Data Coverage","icon":"globe","pages":[{"title":"Data Coverage","href":"/coverage/home"}]},{"tab":"Migrate to T49","icon":"arrow-right-arrow-left","pages":[{"title":"Migrate to T49","href":"/migrate/home"}]},{"tab":"SDK Docs","icon":"rectangle-terminal","pages":[{"title":"SDK Docs","href":"/sdk/introduction"}]},{"tab":"MCP","icon":"plug","pages":[{"title":"MCP","href":"/mcp/home"}]},{"tab":"DataSync","icon":"database","pages":[{"title":"DataSync","href":"/datasync/home"}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/updates/home"}]}]},"title":"Get a Vessel by IMO Number | Terminal49 API","buildId":"dpl_AUojGTPodKNPTVaxVPcxnNvkSVqo","deploymentId":"dpl_AUojGTPodKNPTVaxVPcxnNvkSVqo","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-D2GYGXhJ.js","utils-BFd71lo2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-i162M7Za.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-oUw0la6W.js","snippetPresets-DtIWL37f.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BCMBbEQM.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DC4RgS91.js","shallow-CgVeLRFv.js","getApiPlaygroundDisplay-D5biMY5x.js","CodeSnippet-BFsbT-Fu.js","CodeSnippets-zLLOIece.js","Page-Ddn8iQDL.js","getPastedJson-BrHW4jRt.js","icon-CkMCp-Tk.js","MethodPill-CCcSM-Ep.js","DuplicateIcon-4tBrFI-V.js","createIcon-YbZxtfvX.js","DynamicMarkdown-BQC1aHST.js","SectionHeading-Dyh8yRs0.js","axios-vUo_bRtp.js","Markdown-DnRxVfNy.js","clsx-BHwt7gjg.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CI1QhstW.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ctpizp2W.js"]}