Book a DemoGet Started Free
Developer Platform

Build on Transportial

A full REST API, App Store SDK, webhook framework, and OTM5-native data model. Everything you need to build logistics software on a platform already running in production.

Read the DocsGet API Access Free
OpenAPI 3.0API standard
RESTHTTP interface
OTM5Open standard
WebhooksEvent system
Transportial REST API
# Authenticate with your API key
x-api-key: <key>
x-api-secret: <secret>
https://api.transportial.com/api
POST /vrp/solve # multi-modal VRP
POST /load-plan/calculate # 3D load planning
POST /route/calculate:alternatives # toll and CO2
GET /adr/un-numbers # public ADR lookup
# App installation token
POST /oauth/token grant_type=client_credentials&installation_id=…
Full API reference, guides, and SDK docs atdocs.transportial.com
Open Documentation
MCP serverConnect Claude, ChatGPT & Cursor
MCP server
Algorithms

Call our algorithms without using Transportial

The optimisers and calculators behind the platform, as plain API calls. Send the input, get the answer. Nothing has to exist in Transportial first.

Multi-modal vehicle routing

Tours for your whole operation: vehicles, trailers, chauffeurs and capacity contracts, across road, rail, barge, sea and air.

POST /vrp/solveSee the example

3D load planning

Every unit positioned in trailers and containers, with stacking, unload order, payload and axle loads.

POST /load-plan/calculateSee the example

Routing, toll and emissions

A route with its toll and emissions in one response, without saving a trip.

POST /route/calculate:georeferencesSee the example

Geocoding and address validation

Coordinates for an address, and a check that it is real before a truck leaves.

POST /location/geocode/addressGeoReferenceSee the example

Compliance data and documents

ADR lookups by UN number, tachograph file parsing, and spreadsheets turned into rows.

GET /adr/un-numbersSee the example
Quick Start

Up and running in minutes

No complex onboarding. Get your API key, read the docs, and make your first API call.

Create a free account

Register at portal.otms.transportial.com, no credit card required. Then create an API access integration for a key and secret.

Read the documentation

Browse the full OpenAPI 3.0 spec, guides, and code examples at docs.transportial.com.

Make your first API call

Use your API key to list transport orders, create trips, or stream vehicle positions, all over standard REST.

Build and publish

Build your integration, white-label deployment, or App Store app, then submit it to the Transportial marketplace.

Your first API call:
curl "https://api.transportial.com/api/adr/un-numbers?search=1203&max=1"
API Reference

What you can build with the API

Every major resource in Transportial is exposed via REST. Full CRUD, filtering, pagination, and webhook events.

Transport Orders

Create & manage transport orders

Full lifecycle management: create, update, assign, and track transport orders. Filter by status, date, customer, and more.

View docs
Trip Management

Optimise and execute trips

Trigger VRP trip optimisation, assign drivers and vehicles, manage multi-leg trips, and track execution in real time.

View docs
Tracking & Telemetry

Live GPS & IoT telemetry

Stream live vehicle positions, driver status, and sensor telemetry. Integrates with Trimble, ZF Transics, and custom IoT.

View docs
Webhooks

Subscribe to real-time events

Register webhooks for 75+ event types: order created, trip started, driver late, invoice paid, and more. HMAC-signed payloads.

View docs
Pricing Engine

Query and configure pricing rules

Create rate cards, apply fuel surcharges, trigger automated invoicing. Full TQL query language for dynamic pricing logic.

View docs
Documents

Generate transport documents

Auto-generate CMR waybills, delivery notes, and customs documents from transport order data. PDF export included.

View docs
Users & Permissions

Manage users and access control

200+ named permissions, role-based access control, SAML 2.0 SSO, and JWT auth with TOTP 2FA. Enterprise-ready.

View docs
App Store

Build and publish marketplace apps

Use the App Store SDK to embed custom panels in any view. Publish to the Transportial marketplace or deploy privately.

View docs
App Store

Extend the platform with your own apps

Build an app once and install it for yourself, one customer or every Transportial tenant: embed your pages in trip, order and vehicle views, on the dashboard or as a menu page, and receive signed webhooks.

  • UI extensions: your page in a sandboxed iframe in trip, order, vehicle, dashboard or menu slots
  • A signed context token tells your page who is looking at what
  • OAuth installation tokens scoped to the permissions the customer approved
  • Signed webhooks with retries and a delivery log
  • Private apps via an install link, or public in the App Store after review
  • Your own sandbox platform with demo data and simulated vehicles
App developer guideCreate a developer account
trip-tab.js
// Your page runs in a sandboxed iframe in the trip view
window.parent.postMessage({ type: 'transportial:ready' }, '*')
window.addEventListener('message', ({ data }) => {
if (data.type === 'transportial:context')
await verify(data.token) // trip id, user, platform
})
window.parent.postMessage({ type: 'transportial:resize', height: 480 }, '*')
Integration Framework

Connect any external system

The built-in integration pipeline handles queue management, retry logic, status tracking, and error handling, so you focus on mapping, not infrastructure.

REST API

Full OpenAPI 3.0 specification. API key authentication with per-key rate limiting, IP allowlisting, and detailed request logs.

FTP Server & EDI

Built-in FTP server with EDI file parsing for legacy shipper systems. Supports EDIFACT, X12, and custom flat-file formats.

Webhooks & Events

Subscribe to 75+ platform events with HMAC-verified webhook payloads. Configurable retry with exponential backoff.

SAML 2.0 SSO

Enterprise identity federation with any SAML 2.0 IdP: Azure AD, Okta, Google Workspace, and more.

OTM5 Standard

Native OTM5 data model for interoperability with the broader European freight transport ecosystem.

Custom Connectors

Build custom integration connectors using the integration framework SDK and deploy them to any Transportial tenant.

Open Source

Built in the open

We believe the best infrastructure is shared. Transportial publishes open-source libraries that power our own platform, free for any developer to use.

GSJson

KotlinJavaScript

Fast JSON getter/setter for JVM & JavaScript

A powerful JSON path library inspired by GJSON. Query and mutate JSON with dot-notation paths, wildcards, array filters, modifiers, and back-references, in both Kotlin/Java and JavaScript/TypeScript.

# Query nested JSON with a clean path syntax
GSJson.get(json, 'name.first') // → "Tom"
GSJson.get(json, 'friends.[age > "40"].[#.first]') // → ["Dale","Roger","Jane"]
GSJson.get(json, 'children|@reverse|@join') // → "Jack,Alex,Sara"
npm installgsjson
View on GitHub
github.com/Transportial

Developer resources

Everything you need to go from idea to production.

API Reference

Full OpenAPI 3.0 spec with interactive Swagger UI. Explore every endpoint, schema, and response code.

Browse API reference

OpenAPI Spec

Download the raw OpenAPI JSON/YAML spec for code generation, client SDKs, or integration testing.

Download spec

App manifest & UI extensions

Declare permissions, settings, UI slots and webhooks, and talk to the portal from your embedded page over postMessage.

View app guide

Webhook Guide

Payload schemas, event catalogue, HMAC signature verification, and a testing sandbox.

Read webhook guide

App Store Guide

Step-by-step guide to building, submitting, and maintaining a Transportial marketplace app.

Read app store guide

Developer Support

Email our developer relations team for technical questions, integration help, or partnership enquiries.

Email the team

Ready to build?

Get your API key for free, read the docs, and make your first call in minutes.

Read the DocsGet API Access Free