Job Feed API

The Job Feed is the external-facing integration point for loading planned journeys into the Loadcircle Global OS. Feeds are polled or pushed as structured job objects that the OS reconciles against driver, vehicle, and compliance records.

Feed Types

Type	Direction	Latency	Use Case
Pull (HTTPS)	OS polls endpoint	~2-5 min	Existing TMS with APIs
Webhook	System pushes to OS	<30s	Real-time job creation
CSV	S3/GCS bucket drop	~15 min	Legacy systems / batch
Manual	Console UI entry	Instant	Ad-hoc / testing

Job Object Schema

{
  "loadRef": "ABC123",
  "origin": {"lat": 51.5, "lng": -0.12, "name": "London Depot"},
  "destination": {"lat": 48.85, "lng": 2.35, "name": "Paris Hub"},
  "scheduledPickup": "2026-06-14T08:00:00Z",
  "scheduledDelivery": "2026-06-15T14:00:00Z",
  "weight": 18000,
  "volume": 45,
  "hazmatClass": null,
  "requiredPermits": ["Cross-border FR"],
  "notes": "Dock 7, use rear ramp"
}

Job Lifecycle

Pending → Assigned → En Route → Completed
           ↕            ↓
        Reassigned   Exception (→ HITM queue)

Exceptions (compliance flag, partner mismatch, routing violation) are escalated to the HITM Oversight Queue for operator review.