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)

    Transmission

    {
        "transmissionHeader": {
            "transmissionID": "TXN-1783526651038",
            "transmissionDateTime": "2019-08-24T14:15:22.123Z",
            "triggerType": "MANUAL_TRIGGER",
            "triggeredByEvent": "6eb45393-ab66-4c0f-ae8a-3249c3b1bc72",
            "senderID": "FREIGHTLENS",
            "receiverID": "CLIENT",
            "schemaVersion": "1.2"
        },
        "shipmentTracking": {
            "bookingReference": "string",
            "carrierBookingReference": "string",
            "billOfLadingNumber": "string",
            "carrierCode": "HLCU",
            "carrierName": "Hapag-Lloyd",
            "vesselName": "string",
            "voyageNumber": "string",
            "portOfLoading": {
                "locationName": "VUNG TAU",
                "unLocationCode": "VNVUT",
                "facilityCode": "CMIT",
                "facilityCodeListProvider": "BIC"
            },
            "portOfDischarge": {
                "locationName": "VUNG TAU",
                "unLocationCode": "VNVUT",
                "facilityCode": "CMIT",
                "facilityCodeListProvider": "BIC"
            },
            "placeOfReceipt": {
                "locationName": "VUNG TAU",
                "unLocationCode": "VNVUT",
                "facilityCode": "CMIT",
                "facilityCodeListProvider": "BIC"
            },
            "placeOfDelivery": {
                "locationName": "VUNG TAU",
                "unLocationCode": "VNVUT",
                "facilityCode": "CMIT",
                "facilityCodeListProvider": "BIC"
            },
            "serviceType": "PORT_TO_PORT",
            "etd": "2019-08-24T14:15:22.123Z",
            "eta": "2019-08-24T14:15:22.123Z",
            "references": {
                "property1": "string",
                "property2": "string"
            },
            "shipmentEvents": [
                {
                    "eventID": "d66eb199-edae-4511-96e7-d2277ccf1d87",
                    "eventType": "SHIPMENT",
                    "documentID": "string",
                    "eventDateTime": "2019-08-24T14:15:22.123Z",
                    "documentTypeCode": "BKG",
                    "documentReferences": [
                        {
                            "documentReferenceType": "BKG",
                            "documentReferenceValue": "29402735"
                        }
                    ],
                    "eventClassifierCode": "ACT",
                    "eventCreatedDateTime": "2019-08-24T14:15:22.123Z",
                    "shipmentEventTypeCode": "CONF"
                }
            ],
            "transportEvents": [
                {
                    "eventID": "d66eb199-edae-4511-96e7-d2277ccf1d87",
                    "eventType": "TRANSPORT",
                    "eventDateTime": "2019-08-24T14:15:22.123Z",
                    "transportCall": {
                        "vessel": {
                            "vesselName": "ULSAN EXPRESS",
                            "vesselIMONumber": "9613020"
                        },
                        "location": {
                            "locationName": "VUNG TAU",
                            "unLocationCode": "VNVUT",
                            "facilityCode": "CMIT",
                            "facilityCodeListProvider": "BIC"
                        },
                        "facilityCode": "string",
                        "unLocationCode": "string",
                        "modeOfTransport": "VESSEL",
                        "facilityTypeCode": "POTE",
                        "exportVoyageNumber": "string",
                        "importVoyageNumber": "string",
                        "facilityCodeListProvider": "BIC",
                        "transportCallSequenceNumber": 0
                    },
                    "documentReferences": [
                        {
                            "documentReferenceType": "BKG",
                            "documentReferenceValue": "29402735"
                        }
                    ],
                    "eventClassifierCode": "ACT",
                    "eventCreatedDateTime": "2019-08-24T14:15:22.123Z",
                    "transportEventTypeCode": "ARRI"
                }
            ],
            "exceptions": [
                {
                    "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"
                }
            ],
            "containers": [
                {
                    "containerNumber": "HAMU4486106",
                    "isoType": "45GP",
                    "references": {
                        "property1": "string",
                        "property2": "string"
                    },
                    "latestEvent": {
                        "eventID": "d66eb199-edae-4511-96e7-d2277ccf1d87",
                        "eventType": "EQUIPMENT",
                        "eventDateTime": "2019-08-24T14:15:22.123Z",
                        "eventLocation": {
                            "locationName": "VUNG TAU",
                            "unLocationCode": "VNVUT",
                            "facilityCode": "CMIT",
                            "facilityCodeListProvider": "BIC"
                        },
                        "transportCall": {
                            "vessel": {
                                "vesselName": "ULSAN EXPRESS",
                                "vesselIMONumber": "9613020"
                            },
                            "location": {
                                "locationName": "VUNG TAU",
                                "unLocationCode": "VNVUT",
                                "facilityCode": "CMIT",
                                "facilityCodeListProvider": "BIC"
                            },
                            "facilityCode": "string",
                            "unLocationCode": "string",
                            "modeOfTransport": "VESSEL",
                            "facilityTypeCode": "POTE",
                            "exportVoyageNumber": "string",
                            "importVoyageNumber": "string",
                            "facilityCodeListProvider": "BIC",
                            "transportCallSequenceNumber": 0
                        },
                        "emptyIndicatorCode": "LADEN",
                        "equipmentReference": "string",
                        "eventClassifierCode": "ACT",
                        "eventCreatedDateTime": "2019-08-24T14:15:22.123Z",
                        "equipmentEventTypeCode": "GTIN"
                    },
                    "eventHistory": [
                        {
                            "eventID": "d66eb199-edae-4511-96e7-d2277ccf1d87",
                            "eventType": "EQUIPMENT",
                            "eventDateTime": "2019-08-24T14:15:22.123Z",
                            "eventLocation": {
                                "locationName": "VUNG TAU",
                                "unLocationCode": "VNVUT",
                                "facilityCode": "CMIT",
                                "facilityCodeListProvider": "BIC"
                            },
                            "transportCall": {
                                "vessel": {
                                    "vesselName": "ULSAN EXPRESS",
                                    "vesselIMONumber": "9613020"
                                },
                                "location": {
                                    "locationName": "VUNG TAU",
                                    "unLocationCode": "VNVUT",
                                    "facilityCode": "CMIT",
                                    "facilityCodeListProvider": "BIC"
                                },
                                "facilityCode": "string",
                                "unLocationCode": "string",
                                "modeOfTransport": "VESSEL",
                                "facilityTypeCode": "POTE",
                                "exportVoyageNumber": "string",
                                "importVoyageNumber": "string",
                                "facilityCodeListProvider": "BIC",
                                "transportCallSequenceNumber": 0
                            },
                            "emptyIndicatorCode": "LADEN",
                            "equipmentReference": "string",
                            "eventClassifierCode": "ACT",
                            "eventCreatedDateTime": "2019-08-24T14:15:22.123Z",
                            "equipmentEventTypeCode": "GTIN"
                        }
                    ]
                }
            ]
        }
    }
    Built with