BloG

Cargo API Integration: Your Shipments, Inside Your Own System

Your shipments, inside your own system

You do not need a second website to track containers. SeaVantage sends the tracking data to the system your team already uses — your ERP, your portal, your spreadsheet replacement. This page shows how, using one sample shipment.

Step 1 — SeaVantage tracks it: carrier, vessel and port data, kept up to date.

‍Step 2 — The API carries it: a standing connection between our system and yours.

‍Step 3 — Your team sees it: route, vessel, ETA and events — on your own screens.

‍

What is an API?

It is a pipe between two systems. SeaVantage puts shipment data in one end. Your system takes it out the other end and shows it your way. The data travels as a text file called JSON. It looks like code. It is just labelled facts — as the demo below shows.

That pipe can work two ways. Option A moves the data itself into your system, so your screens show it your way. Option B shows our tracking page inside your system, with no data work at all. Here is Option A.

‍

Option A — the API: our data, your screens

On the left is the data SeaVantage sends for one shipment — Master B/L 276594731, Maersk, Busan to Ho Chi Minh City. On the right is a dummy customer system: a made-up manufacturer’s inbound board. Tap any block of data on the left. The matching part of their screen lights up. That is the whole idea of an API.

Live demo — one shipment, two views Sample data · dummy customer system

The shipment ID. "mblNo": "276594731" is the Master B/L number. On their screen it is simply the heading of the shipment card — the number their team searches by.

What SeaVantage sends the JSON file

{
}

Shortened for readability. The full file carries every port call, terminal and event for all six containers — your system picks the parts it wants.

What their team sees their own system

Meridian Manufacturing — Inbound Board Dummy system

Shipment

276594731 Maersk · Master B/L Before departure

Route

BusanBusan New Port Terminal Transshipment · Nansha Ho Chi Minh CityCat Lai Terminal
Departure · Busan
Oct 4, 01:00
Carrier ETD
Arrival · Ho Chi Minh City
Oct 9, 06:00
Carrier ETA
SeaVantage predicted arrival (PTA)
Oct 6, 23:11
An early signal that sits next to the carrier ETA — so planners can flag a possible slip and check, not a replacement for the carrier date.

Vessel

NORDLEOPARD · Voyage 640W · IMO 9626261
Second leg from Nansha: ERASMUS EFFORT, voyage 641S.

Containers · 6

MRKU7536745MRSU0927231MRSU1227973 TEMU1413909TEMU2145185TLLU2287724

All 20ft dry · All six on Master B/L 276594731

Latest events

Empty equipment dispatched
Busan New Port Terminal
Sep 1515:46 · Actual
Vessel departure
Nansha · ERASMUS EFFORT 641S
Oct 602:00 · Est.
Vessel arrival
Ho Chi Minh City · Cat Lai Terminal
Oct 906:00 · Est.

This manufacturer chose route, dates, vessel, containers and events. Your system shows only the fields your team wants — in your layout, your colours, your language.

Option B — screen embedding: our page, inside your system

No data work at all. Your team stays in your system. They click a shipment number, and the actual SeaVantage tracking screen opens right there — shipment milestones on the left, the route map on the right, for the same sample shipment as the API demo above. Try it: click the shipment number below.

Live demo — click a shipment number Dummy system · the pop-up shows the actual SeaVantage tracking screen
Meridian Manufacturing — Inbound Shipments Dummy system
Shipment (Master B/L)RouteCarrier ETAStatus
Click me Busan → Ho Chi Minh CityOct 9, 06:00Before departure
274881205 Shanghai → BusanOct 12, 14:30Booked
269310477 Ho Chi Minh City → IncheonOct 2, 09:15Arrived
Tap me
Busan → Ho Chi Minh City
Carrier ETA Oct 9, 06:00 · Before departure
274881205
Shanghai → Busan
Carrier ETA Oct 12, 14:30 · Booked
269310477
Ho Chi Minh City → Incheon
Carrier ETA Oct 2, 09:15 · Arrived

That click is the whole feature. The list is theirs. The tracking page that opens is ours, shown inside their system. Their team never opens a second tool, and there is nothing for them to build beyond adding the link.

Two ways in. Same data.

Most customers start with one and add the other later. Neither needs your team to change how it works today.

Option A

API — the data pipe

SeaVantage sends the raw facts. Your system shows them in your own design, next to your own data — purchase orders, production plans, customer orders.

  • Full control over what is shown and where
  • Data can drive alerts, reports and planning rules
  • Your developer connects it once; updates then flow on their own

Best when: you have a system your team lives in, and a developer who can spend a short time connecting it.

Option B

Screen embedding — the window

Your system links each shipment number to the ready-made SeaVantage tracking page. One click opens the full picture — no data handling on your side.

  • Nothing to build beyond the link itself
  • Full tracking detail: route, milestones, all containers
  • Works from any screen that can hold a link — ERP, portal, intranet

Best when: you want tracking inside your system fast, with no development work.

What happens next

Three steps. Only step 2 involves a developer, and SeaVantage supports them.

STEP 1

You pick the shipments

Tell us the B/L or container numbers to track — or register them in Cargo Insight. That is the list the data covers.

STEP 2

Your developer connects once

We give them access and the technical guide. They connect your system to the API, or add the embedding link to your shipment numbers.

STEP 3

Your team just looks

Dates, vessels and events stay current on your own screens. No logins to chase, no carrier websites to check by hand.

‍

Want the full detail? The API documentation lists every endpoint. The screen embedding guide covers tokens, URLs, and setup.

‍

Frequently asked questions

1. What is the SeaVantage Cargo Insight API?

The Cargo Insight API is the connection that carries container tracking data from SeaVantage into your own system. It tracks shipments by bill of lading, booking, or container number across carriers for B/L and booking lookups, and container-number lookups. Your team sees the data on your own screens instead of logging into a second website.

2. How does Cargo Insight API integration work?

SeaVantage issues your API credentials, and your developer authorizes them once in Swagger. Your system registers shipments with POST /cargo/bulk, tracks them with GET /cargo/search, and sets alerts with POST /alert/cargo. From there, route, vessel, ETA, and events flow into your ERP, portal, or dashboard.

3. What data does the Cargo Insight API return?

For each shipment, the API returns the carrier, vessel name, voyage, and IMO number; the route with loading, transshipment, and discharge ports; carrier ETD and ETA; and the full event history. It also returns SeaVantage's PTA, a predicted arrival shown alongside the carrier ETA as an additional planning signal, not a replacement. The sample in this guide shows one Maersk shipment: Busan → Nansha → Ho Chi Minh City, six 20ft containers.

4. What is screen embedding, and how is it different from the API?

Screen embedding shows a live SeaVantage screen inside your own system. Click a shipment number and the tracking page opens, milestones on the left and route map on the right. The API moves the data into your screens; embedding shows SeaVantage's screen in yours. It works for shipments registered in your Cargo Insight workspace, and needs no custom code: issue a token, build the URL, paste it in an iframe. Tokens last 24 hours and only the two most recent stay valid, so renew about every 12 hours.

5. Do I need a developer to use Cargo Insight in my own system?

For the API, yes — once, to build the connection. For screen embedding, no — anyone who can paste an iframe can set it up. This guide is written for the people who approve the project, not just the people who build it.

6. How do I get access to the Cargo Insight API?

Start with the 7-day free trial. It applies automatically when you create a workspace and covers up to 10 bills of lading for Cargo Insight. API credentials come from SeaVantage once your trial or account is set up.

‍

Start a 7-day free trial

Request a SeaVantage demo

‍

최근 게시물
해상 초크포인트란? 호르무즈 해협부터 세계 주요 초크포인트까지
물류 인사이트
해상 초크포인트란? 호르무즈 해협부터 세계 주요 초크포인트까지

전 세계 물류 운송과 경제의 핵심인 해상 초크포인트의 종류, 위치, 우리나라와의 연관성을 확인해 보세요.

September 17, 2026
북극항로 시범운항: 팬스타 아크로호가 검증하는 북극항로의 상업 운항 가능성
물류 인사이트
북극항로 시범운항: 팬스타 아크로호가 검증하는 북극항로의 상업 운항 가능성

팬스타 아크로호가 지난 8월 22일 북극항로 시범운항을 시작했습니다. 국내 최초 컨테이너선 북극항로 운항 현황과 상업성 검증 항목, 화주·포워더가 주목할 사항을 정리합니다.

September 7, 2026
태풍이 해상운송에 미치는 영향: 선박 운항·항만 지연 확인법
물류 인사이트
태풍이 해상운송에 미치는 영향: 선박 운항·항만 지연 확인법

태풍 발생 시 선박은 우회·감속·대기 등 서로 다르게 대응합니다. AIS 항적과 ETA·PTA·PTB, 항만 혼잡 데이터를 활용해 해상운송 지연 가능성을 판단하는 방법을 알아보세요.

August 10, 2026
Recent Posts
Cargo API Integration: Your Shipments, Inside Your Own System
Knowledge Base
Cargo API Integration: Your Shipments, Inside Your Own System

See how the SeaVantage Cargo Insight API puts container tracking in your own system — JSON to dashboard, plus screen embedding. A visual guide, no code needed.

November 18, 2026
What Ocean Visibility Platform Should Freight Forwarders Use for Multi-Client Dashboards?
Logistics Insight
What Ocean Visibility Platform Should Freight Forwarders Use for Multi-Client Dashboards?

Forwarders need one dashboard per client, not one login per carrier. What to check — and how SeaVantage Cargo Insight covers it.

November 17, 2026
Durban Port Congestion, One Week Later: 28 Ships Waiting and an 18-Day Tail
Logistics Insight
Durban Port Congestion, One Week Later: 28 Ships Waiting and an 18-Day Tail

One week on, Port Insight shows 28 ships waiting 6.5 days at Durban, 83 on the way, and one vessel that took 18.5 days to berth.

November 16, 2026