v1Stable

API Dokumentation

Integrate TransAs24 data into your own application or ERP system.

Authentication

All protected API requests require a valid API key in the HTTP header X-Api-Key.

X-Api-Key: tsa_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Manage your API keys here: API Access → Dashboard

Base URL

https://transas24.com/api/v1

All endpoints are relative to this base URL. HTTPS is required.

Endpoints

GET/api/v1/healthNo auth required

Check the API status. No API key required.

{ "status": "ok", "version": "1.0.0" }

GET/api/v1/freightsfreights:read

Returns a paginated list of all published freights.

Query Parameters

Parameter	Typ	Beschreibung
page	number	Seite (Standard: 1)
limit	number	Einträge pro Seite, max. 100 (Standard: 20)
origin	string	Abgangsort (Freitext)
destination	string	Bestimmungsort (Freitext)
vehicleType	string	Fahrzeugtyp (z.B. tautliner, reefer)
minWeight	number	Mindestgewicht in kg
maxWeight	number	Maximalgewicht in kg

Response Example

{
  "items": [
    {
      "id": "clx1abc2def3",
      "title": "Stahltransport Berlin → Warschau",
      "originCity": "Berlin",
      "originCountry": "DE",
      "destCity": "Warschau",
      "destCountry": "PL",
      "weight": 18000,
      "vehicleType": "tautliner",
      "loadingDate": "2026-06-15T08:00:00Z",
      "status": "PUBLISHED"
    }
  ],
  "total": 1240,
  "page": 1,
  "limit": 20
}

GET/api/v1/freights/:idfreights:read

Returns details of a single freight by its ID.

POST/api/v1/freightsfreights:write

Creates a new freight listing. Requires the freights:write scope.

Request Body

Parameter	Typ	Beschreibung
title	string	Frachtbezeichnung (Pflicht)
originCity	string	Abgangsstadt (Pflicht)
originCountry	string	Abgangsland ISO-2 (Pflicht)
destCity	string	Zielstadt (Pflicht)
destCountry	string	Zielland ISO-2 (Pflicht)
weight	number	Gewicht in kg
vehicleType	string	Fahrzeugtyp
loadingDate	string	Ladedatum (ISO 8601)
deliveryDate	string	Lieferdatum (ISO 8601)
price	number	Preis in EUR (optional)
notes	string	Zusätzliche Hinweise (optional)

GET/api/v1/carrierscarriers:read

Returns a paginated list of verified carriers.

{
  "items": [
    {
      "id": "clx4xyz5abc6",
      "companyName": "Mustermann Spedition GmbH",
      "country": "DE",
      "vehicleTypes": ["tautliner", "reefer"],
      "rating": 4.8,
      "verified": true
    }
  ],
  "total": 340,
  "page": 1,
  "limit": 20
}

Rate Limits

1.000

Requests per day per API key (reset at UTC midnight)

If exceeded, HTTP 429 is returned. The X-RateLimit-Remaining header shows remaining requests.

Response Format

All API responses are in JSON format with UTF-8 encoding.

Content-Type: application/json; charset=utf-8

Error Codes

Error responses follow a consistent JSON schema.

Parameter	Typ	Beschreibung
401	Unauthorized	API-Key fehlt oder ungültig
403	Forbidden	Fehlende Scope-Berechtigung
404	Not Found	Ressource nicht gefunden
422	Validation Error	Ungültige Eingabedaten
429	Too Many Requests	Rate-Limit überschritten (1.000 req/Tag)
500	Internal Server Error	Serverfehler — bitte erneut versuchen

Error Response Example

{
  "statusCode": 422,
  "error": "Validation Error",
  "message": "originCity is required"
}