Logistica REST API

Start

Base URL: https://alfaloji.forum/api/v1. The key is created by the company owner on the Integrations page; it’s shown only once. “Read” keys can only make GET requests. Each key is limited to 120 requests per minute (X-RateLimit-Remaining header).

Dates are returned in ISO 8601 (UTC); when sending, include a time zone or write local time according to the listing’s timezone field. IDs match the platform: UUID for listings, offer T-…, deal A-…, company F-….

Authentication

curl https://alfaloji.forum/api/v1/me \
  -H "Authorization: Bearer lgk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

A key works with the permissions of the person who created it. If they leave the company or lose permissions, the key stops working; create a new one. Never put the key in client-side code (browser, mobile app).

Responses and errors

Successful responses are {"data": …}, errors {"error": {"code", "message"}} . The message language follows the Accept-Language header (tr, en, ru).

Account

Listings

Marketplace

Bids

Deals and location

Telematics and rentals

Webhooks

Choose an https URL and events on the Integrations page. Each event is POSTed as JSON; if you don’t return 2xx within 10 seconds it’s retried 6 times with increasing intervals. The same event may arrive more than once; id deduplicate by the id field.

POST /logistica/webhook
X-Logistica-Event: deal.stage_changed
X-Logistica-Signature: t=1790260000,v1=5f1c…

{"id":"evt_…","event":"deal.stage_changed","created_at":"2026-09-24T10:15:00+00:00",
 "data":{"deal":{"id":"A-3110","stage":2,"stage_label":"Taşımada", …}}}

Verify the signature: hex(HMAC_SHA256(imza_anahtarı, t + "." + ham_gövde)) == v1 and t must not be older than 5 minutes.

$sig = $_SERVER['HTTP_X_LOGISTICA_SIGNATURE'];
preg_match('/t=(\d+),v1=([0-9a-f]+)/', $sig, $m);
$ok = abs(time() - (int)$m[1]) 
   
offer.created
New offer received
offer.accepted
Your bid was accepted
offer.rejected
Your bid was declined
offer.withdrawn
Bid withdrawn
deal.created
Deal created
deal.stage_changed
Transport stage changed
deal.completed
Deal completed
deal.cancelled
Deal cancelled
deal.disputed
Dispute opened
message.created
New message
listing.published
Listing published
listing.closed
Listing closed
rental.requested
Rental request
rental.accepted
Rental approved
rental.declined
Rental declined
rental.cancelled
Rental cancelled/withdrawn
tender.awarded
Tender won
escrow.funded
Protected payment funded
escrow.released
Protected payment released
escrow.refunded
Protected payment refunded

Example flow: cargo listing from a TMS

curl -X POST https://alfaloji.forum/api/v1/listings \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -d '{
  "kind": "cargo", "title": "İstanbul → Münih tekstil",
  "origin": {"city": "İstanbul", "country": "Türkiye"},
  "destination": {"city": "Münih", "country": "Almanya"},
  "transport_mode": "FTL", "vehicle_type": "tent", "weight_kg": 18000,
  "available_from": "2026-10-01T08:00:00+03:00", "available_until": "2026-10-03T18:00:00+03:00",
  "timezone": "Europe/Istanbul", "price_type": "offer", "currency": "EUR", "publish": true }'

Bids offer.created webhook. Accept a suitable offer with POST /offers/T-…/accept ; as the carrier reports loading and delivery you receive deal.stage_changed events, and if a vehicle is linked GET /deals/A-… returns the last location.

Vehicle types: tent (Tenteli), refrigerated (Frigorifik), box (Kapalı kasa), flatbed (Açık kasa), mega (Mega), container (Konteyner taşıyıcı), lowbed (Lowbed), tanker (Tanker).