Ocean Freight Track & Trace API

Track ocean shipments & vessels globally through ports and terminals via real-time API.

Track Ocean Shipments Globally

Track containers in real-time with full visibility across major carriers via API.

Real-Time Container Visibility Through API

Get ETA, port of loading, port of discharge, vessel name, status & more container data.

Use Container Number or BOL to Track Containers

With Bill of Lading number you can get a list of all associated containers to a specific BoL number.

Container data for developers

Standardized JSON. Our container data is available for various programming languages making it easy to integrate it into your application.

Extensive Documentation. Our comprehensive documentation contains request examples, and a full easy-to-follow guide on how to get started with all our API Endpoints.

Responsive Support. To ensure a smooth experience with our API, our dedicated support team is always ready to answer your questions and provide assistance if you need it.

Trusted by 200+ clients globally.

1 +

We track containers across 95% of shipping lines

1 %

With 3+ years of experience, we offer real-time container tracking.

1 +

				
					{
  "data": {
    "container_id": "MEDU9091004",
    "container_type": "40' HIGH CUBE REEFER",
    "container_status": "Empty received at CY",
    "shipping_line_name": "Mediterranean Shipping Company",
    "shipping_line_id": "0015",
    "tare": 3900,
    "shipped_from": "GUAYAQUIL, EC",
    "shipped_from_terminal": "NAPORTEC TERMINAL - BANANAPUERTO ",
    "shipped_to": "TRIPOLI, LY",
    "shipped_to_terminal": "SPCO ( SOCIALIST PORTS CO UNDER MINISTRY OF TRANSPORT ) ",
    "atd_origin": "2024-07-09 00:00",
    "eta_final_destination": "2024-08-10 00:00",
    "last_location": "TRIPOLI, LY",
    "last_location_terminal": "SPCO ( SOCIALIST PORTS CO UNDER MINISTRY OF TRANSPORT ) ",
    "next_location": "TRIPOLI, LY - CY Depot",
    "next_location_terminal": "AL MOURSSALAT CONTAINER YARD",
    "atd_last_location": "2024-08-11 00:00",
    "eta_next_destination": "2024-08-20 00:00",
    "timestamp_of_last_location": "2024-08-13 00:00",
    "last_movement_timestamp": "2024-08-17 00:00",
    "loading_port": "GUAYAQUIL, EC",
    "discharging_port": "TRIPOLI, LY",
    "customs_clearance": "2024-08-14 00:00",
    "bill_of_lading": "MEDUGY914103",
    "last_vessel_name": "MSC LENA F",
    "last_voyage_number": "YF432A",
    "current_vessel_name": "MSC LENA F",
    "current_voyage_number": "YF432A",
    "last_updated": "2024-09-09 18:34"
  }
}

95% Global Carrier Coverage

From major shipping lines to their partner and leased fleets. In JSONCargo we cover 95% of global ocean trade.

Port-to-Port visibility with vessel tracking

We go beyond just Container Numbers. With our API you can get live vessel positions with Latitude and Longitude data and more. Get complete visibility from port to port on a container’s journey.

				
					{
  "data": {
    "uuid": "b8625b67-7142-cfd1-7b85-595cebfe4191",
    "name": "MAERSK CHENNAI",
    "mmsi": "566093000",
    "imo": "9525338",
    "eni": null,
    "country_iso": "SG",
    "type": "Cargo - Hazard A (Major)",
    "type_specific": "Container Ship",
    "lat": 5.51935,
    "lon": 0.02906167,
    "speed": 0.1,
    "course": 256,
    "heading": 144,
    "navigation_status": null,
    "destination": "CGPNR>GHTEM",
    "last_position_epoch": 1721842560,
    "last_position_UTC": "2024-07-24T17:36:00Z",
    "eta_epoch": 1721633940,
    "eta_UTC": "2024-07-22T07:39:00Z"
  }
}

Multiple containers? Bill of Lading got you covered

With our Bill of Lading Endpoint you can retrieve a list of all container ID’s associated with a specific Bill of Lading (BOL) number.

				
					{
    "data": {
        "bill_of_lading": "SZPE72846000",
        "shipping_line_name": "Hyundai Merchant Marine",
        "shipping_line_id": "0012",
        "associated_containers": 16,
        "associated_container_numbers": [
            "CAIU9933760",
            "CLKU5004260",
            "GAOU6162340",
            "HDMU6653051",
            "HDMU6836237",
            "HMMU6053862",
            "HMMU6541677",
            "HMMU6668297",
            "KOCU4503822",
        ],
        "last_updated": "2025-03-28 04:09"
    }
}

Container Data Pricing

Instant API Key Access. Cancel anytime. 2 weeks moneyback guarantee.

Mariner

For small personal projects

Navigator

Perfect for Startups

Admiral

For large businesses

€9 /then €99 month

7 days trial then €99 monthly

€0.099 per request

€22 /then €199 month

14 days trial then €199 monthly

€0.080 per request

€39 /then €349 month

14 days trial then €349 monthly

€0.070 per request

All your maritime data in a single place

With our powerful API in place you’ll be able to go beyond basic tracking and get access to full end-to-end ocean shipment visibility.

Container Tracking

ETA, ATD, status, Port of Loading, Port of Discharge, and more.

Bill of Lading

Track all associated containers to a B/L number.

Vessel Tracking

Latitude, longitude, destination, speed, course ETA and more.

Port Finder

Data on ports all over the world, location, country, UN/LOCODE, etc.

Vessel Finder & Specs

Find vessel’s by name or IMO and retrieve capacity, dimensions, speed, type and more.

Terminal Finder

Detailed data on terminals worldwide, coordinates, names, and addresses.

Instant API key access

Signing up takes under 5 minutes.

Choose subscription plan. Receive your API key directly to your email. Integrate it into your platform.

Yes, it’s that easy.

Frequently Asked Questions

Get answers to commonly asked questions

How do I start Using JSONCargo Container Tracking API?

To get started, simply visit our pricing page and choose the API plan that best fits your needs. So click “Get API Key” and follow the instructions. After completing the payment, you will receive an API key and container tracking documentation to integrate the container tracking API & vessel database with your application via email. Additionally, if you have any questions, you can always contact us for assistance and support.

Can you explain how API calls are counted?

All API requests made to our system count as one API call, regardless of whether it’s for a new container or vessel or one that you previously tracked before. Here’s how it works:

Tracking Containers: If you track 500 containers three times per week, this equals:
500 containers×3 times/week=1500 API calls/week
Monthly Usage: To estimate your monthly API calls, multiply the weekly calls by the number of weeks in a month (approximately 4.33):

This applies to all endpoints. Make sure to account for any additional requests beyond your current frequency.

Is there a contract or a commitment required to subscribe to shipment API?

No, there is no contract and commitment required. You can cancel your container tracking API subscription anytime without any penalties and fees. Because we believe in providing flexibility of container tracking API solutions to our customers. Therefore, you have the freedom to choose the API plan that suits your business needs without any long-term obligations.

How do I integrate JSONCargo’s API’s with my application?

So, to integrate JSONCargo’s APIs with your application, you can use our documentation and code examples as a guide. We provide detailed documentation for each of our APIs, including endpoint URLs, request and response formats, and sample code in multiple programming languages. So to get started, sign up for an account and choose one of our API solutions, such as the Vessel Tracking API key. By following the provided documentation and code examples, you can easily authenticate your API requests using the provided API key. Once authenticated, you can start making API calls using HTTP and HTTPS protocols.

And if you have any questions you can contact us via email and through our support email support@jsoncargo.com.

What happens if I exceed my monthly API request limit?

So if you exceed your monthly API request limit, you will receive an error message indicating that you have reached your limit. At this point, you have several options to consider. Firstly, you can choose to upgrade to a higher API plan, such as the Carrier Tracking API, which offers higher request limits to accommodate your needs. Alternatively, you can also purchase additional Live Container Tracking API requests to cover the overage. And the overage charges will be billed to your account at the rate specified in your plan. Therefore, to ensure a seamless experience with our Vessel Tracking API or other products, we highly recommend closely monitoring your API usage.

Can I upgrade or downgrade my Pro API plan anytime?

Certainly! We understand that your business needs may evolve over time. Therefore, you have the flexibility to upgrade or downgrade your API plan anytime according to your changing requirements. So, to make the switch, simply log into your account and select the new API plan you wish to switch to. The changes will take effect immediately, and because of the new changes you will be charged the prorated amount for the remaining days of the month. So if you choose to upgrade to a higher container tracking solution, such as the Pro API Plan or Enterprise Plan, you will gain access to additional features and higher request limits. On the other hand, if you decide to downgrade, and your request limits will be adjusted accordingly to align with the chosen plan.