Container Tracking API, Portcast Predictive ETA and Vessels
Pricing
from $15.00 / 1,000 tracked container returneds
Container Tracking API, Portcast Predictive ETA and Vessels
Read ocean container tracking from your Portcast account: predicted and carrier ETAs, milestones, AIS vessel position, container route, delay risks, terminal last free day and holds, vessel tracking, port congestion, sailing schedules and 100+ carrier SCACs. Read only. Bring your own key.
Pricing
from $15.00 / 1,000 tracked container returneds
Rating
0.0
(0)
Developer
Nabeel Hassan
Maintained by CommunityActor stats
0
Bookmarked
3
Total users
2
Monthly active users
23 days ago
Last modified
Categories
Features
Share
Container Tracking API for Portcast: Predictive ETA, Milestones and Vessels
Read the ocean containers tracked in your Portcast account through the Portcast API with your own API key, as clean dataset rows: Portcast predicted ETAs next to carrier ETAs, milestones, AIS vessel positions, routes, delay risks, terminal data, port congestion and sailing schedules.
Portcast is a Singapore based container visibility platform that tracks containers across 100+ ocean carriers and NVOCCs, enriches carrier milestones with AIS vessel data and 70+ other sources, and predicts arrival times with its own machine learning model. This actor wraps the read only part of its documented API on api.portcast.io, so you can pull predicted ETAs into Google Sheets, BI dashboards, ERP or TMS systems, exception alerts or AI agents without writing a client. Bring your own API key.
BYOK, not live tested: every route, parameter and field comes from Portcast's published OpenAPI definitions on portcast.stoplight.io (Container Tracking, Vessel Tracking, Port Congestion and Sailing Schedules APIs), checked on 2026-10-26. The routes were probed with an invalid key on the same day. The actor has not been run against a live Portcast key.
What it does
- Container tracking and predicted ETA: one row per tracked container (Portcast Bill of Lading Bookmark) with container number, bill of lading or booking number, carrier SCAC, tracking status code, port of loading and port of discharge (UN/LOCODE and name), carrier scheduled, Portcast predicted and actual arrival at the port of discharge, actual departure from the port of loading, POD terminal, the final vessel with its IMO and latest AIS position, and the latest milestone. The full Portcast record (every leg, delay reasons, transport plan, CO2 emissions, container size and type) is kept in
attributes. - Container milestone events: one row per standardized milestone (empty pick up, gate in, loaded, departure, transshipment, arrival, unload, gate out, delivered, empty return) with actual and estimated times, port, location type, vessel, voyage and terminal.
- Container route and vessel position: the actual AIS path and the optimal route for each leg, plus the vessel the container is on now with its latest latitude, longitude, speed and course.
- Container risks: active risks per container, such as predicted delay at arrival or departure, port congestion on route, possible rollover, weather events and vessel not attributed.
- Container terminal data: export terminal gate in, earliest receiving dates and cut offs, and import terminal discharge, holds, last free day, demurrage owed, pickup appointment, yard location and gate out (a Portcast add-on).
- Vessel tracking: Portcast vessel bookmarks with origin and target port, scheduled, predicted and actual arrival and voyage details.
- Port congestion: weekly congestion category with vessel waiting and dwell time percentiles, or daily vessels berthed, waiting at anchorage and total waiting time, for any UN/LOCODE.
- Sailing schedules: scheduled sailings between two ports with carrier, legs, vessels, voyages, service routes, terminals and transit time.
- Supported carriers: every carrier SCAC Portcast covers, with SCAC synonyms, bill of lading prefixes and supported upload types.
- Numbers just work: in the route, risk and terminal modes, give container or bill of lading numbers and the actor finds their bookmark IDs first, without charging for that lookup.
- Pay only for results: unknown numbers, empty lists and refused lookups are recorded as a free row that says why, never charged.
How to use it
- Sign in to the Portcast web app and open your profile page (app.portcast.io/profile); your organisation API key is there.
- Paste the key into the API key field (or set the DATA_API_KEY secret). It is sent only to api.portcast.io in the
x-api-keyheader and is removed from everything the actor logs. - Pick a mode, add container numbers, bill of lading numbers, bookmark IDs or ports, and start the run. Download the rows as JSON, CSV or Excel, or call the actor from your own code or a schedule.
Containers must already be tracked in your Portcast account (uploaded through its web app or API). This actor never uploads containers, bookings or vessels, because Portcast bills each new Bookmark ID and a repeated run would create duplicates. Reading tracking data is not billed by Portcast.
A missing or rejected key, or an account without the Port congestion API, ends the run cleanly with a status message that says what to change.
Input
| Field | Modes | Description |
|---|---|---|
mode | all | containers (default), containerEvents, containerRoute, containerRisks, terminalData, vesselTracking, portCongestion, sailingSchedules or carriers |
containerNumbers | Container modes | ISO 6346 container numbers already tracked in Portcast |
billOfLadingNumbers | Container modes | Bill of lading or booking numbers; every tracked container under each is returned |
bookmarkIds | Container modes | Portcast Bill of Lading Bookmark IDs, read directly |
carrierScac | Container modes | One carrier SCAC to narrow lookups or the full listing |
enterpriseCustomer | Container modes | Enterprise accounts only: the customer organisation to read (x-customer header) |
vesselBookmarkIds | Vessel tracking | Portcast Vessel Bookmark IDs |
portCodes, congestionSeries | Port congestion | UN/LOCODEs, and weekly or daily series |
dateFrom, dateTo | Port congestion, Sailing schedules | YYYY-MM-DD window |
originPort, destinationPort | Sailing schedules | Origin and destination UN/LOCODEs (required) |
sailingDateBasis, sailingCarriers, transshipments, nearbyOrigins, nearbyDestinations | Sailing schedules | Dates by departure or arrival, carriers, 0, 1 or 2 transshipments, nearby ports |
maxResults | all | Most rows to return and charge for |
requestsPerMinute | all | Pacing for calls to Portcast |
apiKey | all | Your Portcast API key (secret) |
Output
Every row has flat columns that are easy to filter: bookmarkId, containerNumber, billOfLading, carrierScac, trackingStatus, polLocode, polName, podLocode, podName, podPredictedArrival, podScheduledArrival, podActualArrival, polActualDeparture, vesselName, vesselImo, event, eventCode, eventTime, eventEstimatedTime, locationLocode, locationName, terminalName, lastFreeDay, latitude, longitude, riskCode, date, congestionCategory, transitTime, name and code. The full Portcast record is kept in attributes. Port times are local time at the port, as Portcast reports them. A refused or empty lookup has found set to false and a note with Portcast's own words.
Example container row (identifiers, ports, vessel and position from the Portcast API reference examples; the times are illustrative):
{"mode": "containers","modeLabel": "Container tracking","recordType": "container","query": "TLLU1181321","found": true,"id": "da420d2e-7657-4b2b-80a9-a6a30e58482c","bookmarkId": "da420d2e-7657-4b2b-80a9-a6a30e58482c","containerNumber": "TLLU1181321","billOfLading": "ONEYANRB31646600","carrierScac": "ONEY","trackingStatus": "JOURNEY_IN_PROGRESS","polLocode": "USORF","polName": "NORFOLK","podLocode": "GHTEM","podName": "TEMA","podPredictedArrival": "2026-05-02T06:00:00","podScheduledArrival": "2026-05-04T08:00:00","podActualArrival": null,"polActualDeparture": "2026-04-09T21:30:00","vesselName": "MAERSK PUELO","vesselImo": "9306172","event": "Departure","eventCode": "DEPART","eventTime": "2026-04-09T21:30:00","locationLocode": "USORF","locationName": "NORFOLK","terminalName": "MERIDIAN PORT SERVICE LIMITED","latitude": 26.527666,"longitude": -78.766,"attributes": { "bill_of_lading": { "...": "..." }, "container_event_list": [], "sailing_info_tracking": [], "delay_lists": [], "co2_emissions": {} },"retrievedAt": "2026-10-26T12:00:00.000Z","note": null}
Milestone rows carry event, eventCode (PICKUP, GATEIN, LOAD, DEPART, ARRIVE, UNLOAD, GATEOUT, DELIVER, RETURN and more), eventTime, eventEstimatedTime, locationLocode, code (POR, POL, POT, POD or POA) and the carrier's own wording in name. Route rows carry the current vessel with latitude and longitude. Risk rows carry riskCode and its description in name. Congestion rows carry date, congestionCategory and the waiting and dwell time measures in attributes.
Pricing
| Event | Price | Charged for |
|---|---|---|
container-tracking | 0.015 USD | Each tracked container with its journey and predicted ETA |
container-event | 0.005 USD | Each container milestone |
container-route | 0.01 USD | Each container route with the current vessel position |
container-risk | 0.005 USD | Each active container risk |
terminal-data | 0.01 USD | Each container's export and import terminal data |
vessel-tracking | 0.01 USD | Each vessel bookmark |
port-congestion-metric | 0.005 USD | Each weekly or daily congestion record |
sailing-schedule | 0.005 USD | Each scheduled sailing |
carrier | 0.005 USD | Each supported carrier |
Unknown numbers, empty lists, refused lookups and the number to bookmark ID lookup are never charged. Your Portcast plan is billed separately by Portcast.
FAQ
What is the Portcast API?
Portcast is a container visibility and predictive ETA platform. Its API on api.portcast.io tracks containers by carrier SCAC plus container, booking or bill of lading number; each tracked container gets a Bookmark ID, and from then on Portcast refreshes its milestones, vessel positions and predicted arrival at least twice a day.
Do I need my own Portcast API key?
Yes. This is a bring your own key actor: it calls Portcast with your organisation key, under your plan and its terms. The key is on your profile page in the Portcast web app; if you have no web app access, Portcast sales can set up an account.
Does this actor cost me Portcast tracking credits?
No. Portcast bills per Bookmark ID created by an upload, and its FAQ says reads are not limited. This actor only reads containers you already track; it never uploads a container, booking or vessel.
How do I get the predicted ETA of a container?
Run Container tracking with the container number or bill of lading number. podPredictedArrival is Portcast's machine learning prediction for arrival at the port of discharge, podScheduledArrival is the carrier's schedule and podActualArrival fills in once the vessel arrives. Every leg's predictions are in attributes.sailing_info_tracking.
Where does the vessel position come from?
From AIS data Portcast attaches to each leg. Container tracking returns the final vessel's latest position; Container route returns the vessel the container is on now with its latest AIS fix, plus the actual and optimal route.
What do the terminal data and risk modes need?
Container terminal data is a Portcast add-on (ask support@portcast.io to enable it); without it Portcast refuses each container and the actor records a free row that says so. Container risks returns only ongoing or future risks such as predicted delays, port congestion on route, rollover and weather.
Can I get port congestion and sailing schedules without tracking anything?
Yes, if your plan includes them. Port congestion takes any UN/LOCODE; Sailing schedules searches the top carriers' schedules between two ports. An account without the Port congestion API ends the run with Portcast's own message.
What are the rate limits?
Portcast sets no limit on reads but asks to be told about unusually high volumes. The actor paces itself at 60 requests per minute by default and honours Retry-After on a 429.
Keyword map
container tracking API, predictive ETA API, ocean container tracking, container ETA prediction, bill of lading tracking, booking number tracking, container milestones API, vessel tracking API, AIS vessel position, container route map, shipment delay risk, rollover detection, terminal last free day, demurrage and holds, port congestion API, vessel waiting time, sailing schedules API, carrier SCAC list, NVOCC tracking, Portcast API, Portcast container tracking, Portcast predicted ETA.
Routes and verification
Wrapped routes on https://api.portcast.io/api/v2: /eta/tracking/bill-of-lading-bookmarks, /eta/tracking/bill-of-lading-bookmarks/{bookmark_id}, /eta/tracking/bill-of-lading-bookmarks/{bookmark_id}/container_route, /eta/tracking/bill-of-lading-bookmarks/{bookmark_id}/risks, /eta/tracking/bill-of-lading-bookmarks/{bookmark_id}/import_export_plan, /eta/tracking/vessel-bookmarks/{vessel_bookmark_id}, /port-congestion, /eta/sailing_schedules (a POST search that creates nothing) and /eta/scac. All were probed twice on 2026-10-26 with a deliberately invalid key and answered Portcast's 401 {"Error": "Not authorized"}, while invented paths answered a 404 saying the URL was not found, so every route above exists as documented. Response shapes, filters and fields are taken from the vendor's OpenAPI definitions, not from live data.
Licensing and data use
This actor works only with your own Portcast account and API key, and Portcast's terms apply to everything it returns. Those terms limit the data to your internal business use and forbid reselling it. This actor is not affiliated with or endorsed by Portcast.