API Informationen

SpotCargoHub API – Overview

The SpotCargoHub API enables direct data exchange between transport management systems (TMS), ERP systems, and the SpotCargoHub platform. With an active API connection, transport requests, quotes, and status data can be automatically created, retrieved, or updated—without any manual data entry.

Advantages of API-Connection

✅ Automated data exchange

Transport requests, quotes, and orders are transferred between SpotCargoHub and the internal system without manual input—error-free and in real time.

✅ Faster response times in day-to-day business

Requests and quotes are automatically transmitted and processed, leading to faster decisions and greater competitiveness.

✅ Better data quality & transparency

Uniform data storage between TMS, ERP, and SpotCargoHub – all parties involved see the same information at all times.

✅ Scalable, future-proof processes

New customers, systems, or modules can be flexibly integrated without adapting existing processes – the API grows with your requirements.

Basic-Information

The SpotCargoHub API is accessible via HTTPS and uses the JSON format for data exchange. An isolated sandbox environment is available for testing purposes. Communication takes place exclusively via secure connections (HTTPS).

 

Base-URLs

 

Umgebung

Base-URL

Zweck

Production

https://app.spotcargohub.net/spedOnline/

Live-Data

Sandbox

https://uat-app.spotcargohub.net/spedOnline/

Testenvironment for developers

Authentification

The SpotCargoHub API is protected by an individual (user-specific) API key. The key must be transmitted in the header of each API request. In addition, the header fields Content-Type and Accept are required to transfer the data correctly.

 

Header

 

Header

Wert

Beispiel

spotcargohubApiKey

your API-key

SCHEXAMPLE-1234-5678

Content-Type

application/json

application/json

Accept

application/json

application/json

Important Endpoints

Below you will find an overview of key API routes. These endpoints enable you to place offers, retrieve offer details, check API availability, and more.

 

Overview API-Endpoints

 

Ressource

Endpoint

Methode

Beschreibung

Place Quote

/offer/placeOfferForRequest

PUT

send quote for a request

Quote details

/offer/showOfferDetails

GET

request quote details

Healthcheck

/health

GET

API-Erreichbarkeit prüfen

 

Direct Links to Swagger-Documentation

Sandbox & Testzugang

You can safely test API calls in our sandbox environment. This environment is ideal for developers and system integrators who want to test their own interfaces or implement proof-of-concepts.

This environment is completely separate from live data and contains test objects that you can work with without any risk.

Note:

You need a separate API key to access the sandbox.

You can obtain this by sending an email to: support@spotcargohub.com

 

Example-Request

Below is a typical example request to the sandbox environment, with headers and payload. The example shows how an offer for a transport request can be transmitted via API.

Error and status codes

The API uses standardized HTTP status codes to report successes and errors. The following table provides an overview of the most important codes:

Code

meaning

description

200

OK

request successful

400

Bad Request

input error

401

Unauthorized

API-Key is missing or false

403

Forbidden

No authorization for this action

404

Not Found

Requested resource not found

Developer-Ressources

The following resources are available for more in-depth technical documentation and support:

Contact & Partnerintegration

Do you have questions about API integration or need assistance with technical connection?

Our technical team is happy to help.

 

Contact:

© Copyright 2025 spotcargohub GmbH

Designed and built by beege.digital