FreightLens.io Public API
    • FreightLens Track & Trace API
      • Authentication
        • Get an access token
      • Shipments
        • Look up a shipment by reference
      • Schemas
        • Transmission
        • TransmissionHeader
        • ShipmentTracking
        • Location
        • Vessel
        • TransportCall
        • DocumentReference
        • ShipmentEvent
        • TransportEvent
        • EquipmentEvent
        • Container
        • Exception
        • Impact
        • SubscriptionRequest
        • Subscription
        • TokenResponse
        • Error
    • Getting Started
      • Getting Started with the FreightLens.io Track & Trace API
    • Authentication
      • Authentication
    • DCSA-aligned data elements
      • Data Elements & Enumerations (DCSA-aligned)

    Exception

    FreightLens extension on top of DCSA. Present when triggerType is EXCEPTION_DETECTED or EXCEPTION_RESOLVED.

    {
        "exceptionID": "b159b839-204f-4da9-91b8-353813ba655e",
        "exceptionType": "ETA_DELAY",
        "exceptionCategory": "SCHEDULE",
        "severity": "WARNING",
        "status": "DETECTED",
        "detectedDateTime": "2019-08-24T14:15:22.123Z",
        "resolvedDateTime": "2019-08-24T14:15:22.123Z",
        "resolutionType": "SCHEDULE_RECOVERED",
        "resolutionNote": "string",
        "title": "string",
        "description": "string",
        "relatedEventID": "8e213dd6-b7e0-4721-86dc-3592947f392f",
        "affectedContainers": [
            "string"
        ],
        "impact": {
            "field": "eta",
            "previousValue": "2026-10-01T01:00:00Z",
            "revisedValue": "2026-10-08T09:00:00Z",
            "delayHours": 176
        },
        "recommendedAction": "string"
    }
    Built with