🎉 Welcome to Searoutes' developer page!
At Searoutes, we're empowering developers to create innovative tools and drive customer value by harnessing the power of reliable data.
Our suite of APIs is designed to provide you with comprehensive insights across all modes of transport. From CO2e emissions tracking and planning, to precise vessel routes and positions, locations searches, and weather conditions, our APIs offer a wealth of data points to fuel your projects.
Whether you're building a sustainability report and dashboard, optimizing logistics operations, or enhancing transport solutions applications, Searoutes APIs are your gateway to unlocking actionable intelligence and delivering great user experiences.
Start exploring today and unleash the full potential of your applications with Searoutes APIs!
API collections
Our APIs are organized into 4 collections: report, search , plan and execute.
- Report gathers information of the past: past vessel routes and voyages, past emissions for a shipment, past weather information.
- Search allows you to perform forward and reverse geocoding for locations like ports, airports, zipcodes, as well as searching for the nearest location. You'll also find information about vessels, their services and carrier information.
- Plan is forward looking: plan a vessel voyage, plan CO2e estimations for a shipment, plan weather on route, plan an itinerary for a shipment.
- Execute allows you to choose the greenest or fastest options of next vessel departures for your shipments and retrieve the routing as well as the related emissions.
Guides
Learn how to use our APIs:
- Deep dive into our SFC accredited methodology and what our current models support 🌱 Introduction.
- Read our practical guide for emissions reporting.
- Get a better sense of the methodology for 🛳 Sea transport, ✈️ Air transport, 🚚 Road transport, 🚄 Rail transport and 🛥️ Inland waters.
- Check out key concepts Glossary
Authentication
Find your API keys in the Authentication page. If you are having issues, send us an email to [email protected].
API Versions
Note that this is the documentation page for most recent stable version of Searoutes API. For the previous stable versions, visit this documentation page.
You can jump to our endpoints directly below:
Report
- Our CO2 Shipment calculates the CO2e emissions of shipment on several modes of transport
sea,air,rail,roadandinland-water. - Our Vessel service gives you up to date positions of vessels and estimated travel times to their next destination.
- Our Weather service lets you explore weather data points in the past, at a location or on a route.
Search
- Our Geocoding service searches points of interests, like ports or airports, and provides you with their geolocations.
- Our Search service searches entities used in other endpoints such as carriers or services.
- Our Vessel service allows you to search vessels by name, and find relevant informations on fleets.
Plan
- Our CO2 Plan provides CO2e emissions statistics for a shipment for a given carrier, for a given port pair. This is a great tool to estimate emissions with designated carriers, when planning future shipments.
- Our Itinerary service searches itineraries operated by carriers. You can use it in combination with our CO2 service to explore transport routes.
- Our Route service allows you to plan voyages of vessels, get distances and travel times between ports or points, on land or sea.
- Our Vessel service gives you estimated travel times to their next destination.
- Our Weather service lets you explore weather data points in the future, at a location or on a route.
Execute
- Our Itinerary service returns the possible itinerary solutions and their CO2e emissions in the near future, for a given carrier and a given port pair. It helps selecting the best carriers options, according to their carbon impact, when organizing transport for ready-to-sail shipments.
- Our CO2 service provides CO2 details of an itinerary by hash. You can use it in combination with our Itinerary serviceto explore sailing options.