{"info":{"_postman_id":"a28ebf18-5945-4ddf-8e2c-ac9a3aeeda1e","name":"[dev] Tradlinx Share Link API","description":"<html><head></head><body><h3 id=\"welcome-to-postman-this-is-your-first-collection\">Welcome to Postman! This is your first collection.</h3>\n<p>Collections are your starting point for building and testing APIs. You can use this one to:</p>\n<p>• Group related requests<br>• Test your API in real-world scenarios<br>• Document and share your requests</p>\n<p>Update the name and overview whenever you’re ready to make it yours.</p>\n<p><a href=\"https://learning.postman.com/docs/collections/collections-overview/\">Learn more about Postman Collections.</a></p>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"55482299","collectionId":"a28ebf18-5945-4ddf-8e2c-ac9a3aeeda1e","publishedId":"2sBY4LQ1X2","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-07-09T07:10:29.000Z"},"item":[{"name":"Share Link","item":[{"name":"1. Create or Extend Share Link","id":"f4a97b0d-521e-4fd6-a6b7-3a9dbfa08d12","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"tx-clientid","value":"{{tx-clientid}}"},{"key":"tx-apikey","value":"{{tx-apikey}}"},{"key":"Content-Type","value":"application/json"}],"url":"{{base_url}}/partners/track/v3/cargo-tracks/share-link/:track_mst_id","description":"<ul>\n<li><p>Create a new share link for a shipment, or extend the expiration date of an existing share link.</p>\n</li>\n<li><p>If a valid share link already exists for the shipment, the existing link is returned and its expiration date is extended.</p>\n</li>\n</ul>\n<h5 id=\"response-body\"><strong>Response Body</strong></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Field</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Remark</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>api_version</td>\n<td><code>string</code></td>\n<td>API version</td>\n<td></td>\n</tr>\n<tr>\n<td>content</td>\n<td><code>ShareLink</code></td>\n<td>Share link informaion</td>\n<td></td>\n</tr>\n<tr>\n<td>transaction_time</td>\n<td><code>string</code></td>\n<td>Response timestamp (UTC)</td>\n<td><code>yyyy-MM-dd'T'HH:mm:ss.SSSSSS</code></td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"share-link-data---sharelink\"><strong>Share Link Data - ShareLink</strong></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Field</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Remark</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>track_mst_id</td>\n<td><code>string</code></td>\n<td>Identifier assigned when registering cargo tracking (UUID)</td>\n<td></td>\n</tr>\n<tr>\n<td>url</td>\n<td><code>string</code></td>\n<td>Share link URL</td>\n<td></td>\n</tr>\n<tr>\n<td>end_date_time</td>\n<td><code>string</code></td>\n<td>Share link expiration date/time</td>\n<td>[ISO 8601 date/time format] <code>yyyy-MM-dd'T'HH:mm:ssXXX</code></td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["partners","track","v3","cargo-tracks","share-link",":track_mst_id"],"host":["{{base_url}}"],"query":[],"variable":[{"id":"c36b39cc-d2c5-44b0-ac1f-817c1c3ff321","description":{"content":"<p>Identifier assigned when registering cargo tracking (UUID)</p>\n","type":"text/plain"},"type":"any","value":"","key":"track_mst_id"}]}},"response":[{"id":"a3be812b-9d2c-4141-8635-0b2d29038388","name":"200 OK","originalRequest":{"method":"POST","header":[{"key":"tx-clientid","value":"{{tx-clientid}}"},{"key":"tx-apikey","value":"{{tx-apikey}}"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/partners/track/v3/cargo-tracks/share-link/:track_mst_id","host":["{{base_url}}"],"path":["partners","track","v3","cargo-tracks","share-link",":track_mst_id"],"variable":[{"key":"track_mst_id","value":"","description":"Identifier assigned when registering cargo tracking (UUID)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"api_version\": \"v3\",\n  \"transaction_time\": \"2026-03-18T23:30:40.852291\",\n  \"content\": {\n    \"track_mst_id\": \"550e8400-abcd-efgh-a716-446655440000\",\n    \"url\": \"https://testx.tradlinx.com/TESTTEST1\",\n    \"end_date_time\": \"2026-04-18T00:00:00.000+0000\"\n  }\n}"}],"_postman_id":"f4a97b0d-521e-4fd6-a6b7-3a9dbfa08d12"},{"name":"2. Get Share Links (Bulk)","id":"6e30b594-1542-47da-99cc-38ba6f855bda","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"tx-clientid","value":"{{tx-clientid}}"},{"key":"tx-apikey","value":"{{tx-apikey}}"},{"key":"Content-Type","value":"application/json"}],"url":"{{base_url}}/partners/track/v3/cargo-tracks/share-link?track_mst_ids=[Track MST ID],[Track MST ID]","description":"<ul>\n<li>Retrieve share link information for one or more shipments.</li>\n</ul>\n<h5 id=\"response-body\"><strong>Response Body</strong></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Field</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Remark</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>api_version</td>\n<td><code>string</code></td>\n<td>API version</td>\n<td></td>\n</tr>\n<tr>\n<td>content</td>\n<td><code>ShareLink[]</code></td>\n<td>Share link informaion</td>\n<td></td>\n</tr>\n<tr>\n<td>size</td>\n<td><code>number</code></td>\n<td>Number of items in content</td>\n<td></td>\n</tr>\n<tr>\n<td>transaction_time</td>\n<td><code>string</code></td>\n<td>Response timestamp (UTC)</td>\n<td><code>yyyy-MM-dd'T'HH:mm:ss.SSSSSS</code></td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"share-link-data---sharelink\"><strong>Share Link Data - ShareLink</strong></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Field</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Remark</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>track_mst_id</td>\n<td><code>string</code></td>\n<td>Identifier assigned when registering cargo tracking (UUID)</td>\n<td></td>\n</tr>\n<tr>\n<td>url</td>\n<td><code>string</code></td>\n<td>Sshare link URL</td>\n<td></td>\n</tr>\n<tr>\n<td>end_date_time</td>\n<td><code>string</code></td>\n<td>Share link expiration date/time</td>\n<td>[ISO 8601 date/time format] <code>yyyy-MM-dd'T'HH:mm:ssXXX</code></td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["partners","track","v3","cargo-tracks","share-link"],"host":["{{base_url}}"],"query":[{"description":{"content":"<p>(required) Identifiers assigned when registering cargo tracking (UUID), comma-separated, up to 30</p>\n","type":"text/plain"},"key":"track_mst_ids","value":"[Track MST ID],[Track MST ID]"}],"variable":[]}},"response":[{"id":"554d5078-60d4-4136-badb-691ed5422caa","name":"200 OK","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":"{{tx-clientid}}"},{"key":"tx-apikey","value":"{{tx-apikey}}"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/partners/track/v3/cargo-tracks/share-link?track_mst_ids=[Track MST ID],[Track MST ID]","host":["{{base_url}}"],"path":["partners","track","v3","cargo-tracks","share-link"],"query":[{"key":"track_mst_ids","value":"[Track MST ID],[Track MST ID]","description":"(required) Identifiers assigned when registering cargo tracking (UUID), comma-separated, up to 30"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"content\": [\n    {\n      \"track_mst_id\": \"550e8400-abcd-efgh-a716-446655440000\",\n      \"url\": \"https://testx.tradlinx.com/TESTTEST1\",\n      \"end_date_time\": \"2026-04-18T00:00:00.000+0000\"\n    },\n    {\n      \"track_mst_id\": \"660e8400-abcd-efgh-a716-446655440000\",\n      \"url\": \"https://testx.tradlinx.com/TESTTEST2\",\n      \"end_date_time\": \"2026-04-20T00:00:00.000+0000\"\n    }\n  ],\n  \"size\": 2,\n  \"transaction_time\": \"2026-03-18T15:30:00.000000\"\n}"},{"id":"a98f9198-0423-446b-a78e-2c89b138b581","name":"400 Error","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":"{{tx-clientid}}"},{"key":"tx-apikey","value":"{{tx-apikey}}"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/partners/track/v3/cargo-tracks/share-link?track_mst_ids=[Track MST ID],[Track MST ID]","host":["{{base_url}}"],"path":["partners","track","v3","cargo-tracks","share-link"],"query":[{"key":"track_mst_ids","value":"[Track MST ID],[Track MST ID]","description":"(required) Identifiers assigned when registering cargo tracking (UUID), comma-separated, up to 30"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"error_detail\": \"Resource not found.\",\n  \"transaction_time\": \"2026-03-18 09:13:36\",\n  \"message\": \"RESOURCE_NOT_FOUND\"\n}"},{"id":"55c6dc5f-a491-43a9-9737-41e427cfa799","name":"400 Error (2)","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":"{{tx-clientid}}"},{"key":"tx-apikey","value":"{{tx-apikey}}"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/partners/track/v3/cargo-tracks/share-link?track_mst_ids=[Track MST ID],[Track MST ID]","host":["{{base_url}}"],"path":["partners","track","v3","cargo-tracks","share-link"],"query":[{"key":"track_mst_ids","value":"[Track MST ID],[Track MST ID]","description":"(required) Identifiers assigned when registering cargo tracking (UUID), comma-separated, up to 30"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"error_detail\": \"[track_mst_ids]: Required field is not provided.\",\n  \"transaction_time\": \"2026-03-18 23:22:27\"\n}"},{"id":"a2f24939-c90c-4a6b-8066-4e5462c13f68","name":"403 Error","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":"{{tx-clientid}}"},{"key":"tx-apikey","value":"{{tx-apikey}}"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/partners/track/v3/cargo-tracks/share-link?track_mst_ids=[Track MST ID],[Track MST ID]","host":["{{base_url}}"],"path":["partners","track","v3","cargo-tracks","share-link"],"query":[{"key":"track_mst_ids","value":"[Track MST ID],[Track MST ID]","description":"(required) Identifiers assigned when registering cargo tracking (UUID), comma-separated, up to 30"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"error_detail\": \"This feature is not supported on your current plan.\",\n  \"transaction_time\": \"2026-03-18T07:21:13\",\n  \"message\": \"UNSUPPORTED_FEATURE\"\n}"},{"id":"2b2be35a-8961-4ba1-946f-2531643a2e30","name":"500 Error","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":"{{tx-clientid}}"},{"key":"tx-apikey","value":"{{tx-apikey}}"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/partners/track/v3/cargo-tracks/share-link?track_mst_ids=[Track MST ID],[Track MST ID]","host":["{{base_url}}"],"path":["partners","track","v3","cargo-tracks","share-link"],"query":[{"key":"track_mst_ids","value":"[Track MST ID],[Track MST ID]","description":"(required) Identifiers assigned when registering cargo tracking (UUID), comma-separated, up to 30"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": 500,\n  \"type\": \"Internal Server Error\",\n  \"message\": \"Internal server error. Please try again in a few minutes.\"\n}"}],"_postman_id":"6e30b594-1542-47da-99cc-38ba6f855bda"}],"id":"9da1cd38-dfa3-4e06-952e-0936b84f8b67","description":"<h2 id=\"✅-share-link-api--overview\">✅ Share Link API — Overview</h2>\n<p>Tradlinx provides Share Link as an extension of the B/L Tracking API. This page covers Share Link only.</p>\n<p>Share Link allows you to generate a secure, shareable link for shipments registered through the B/L Tracking API. Recipients can view shipment tracking information, including shipment status, vessel movements, routes, and container events, without signing in to Tradlinx.</p>\n<p>Share Link is available only for shipments registered under the B/L Tracking API.</p>\n<h2 id=\"✅-enterprise-plan-required\">✅ Enterprise Plan Required</h2>\n<p>The Share Link API is available exclusively as an add-on feature for customers subscribed to the Ocean Visibility Enterprise Plan and requires the B/L Shipment Tracking API.</p>\n<p>To upgrade your plan to Enterprise Plan, contact our sales team.</p>\n<p>→ <a href=\"https://calendly.com/d/crw3-rjw-2ft/ocean-visibility-video-chat-30-minutes\">Schedule A Meeting</a></p>\n","_postman_id":"9da1cd38-dfa3-4e06-952e-0936b84f8b67"}]}