Sea Tracking Event Created

Developing

Webhook

POST

Sent when a new tracking event is recorded for one of your sea shipments.

Request

Header Params

Body Params application/json

Example

{
  "webhookId": 12,
  "eventName": "sea_tracking_events/create",
  "deliveryId": "56c9977c-8aed-4d84-839e-1c195bf13a1f",
  "sentAt": "2026-09-22T09:44:55Z",
  "data": [
    {
      "eventID": "681e6e97-0fdb-5043-a287-3855485e1cb1",
      "eventType": "EQUIPMENT",
      "eventClassifierCode": "ACT",
      "eventDateTime": "2026-09-21T17:00:00Z",
      "eventCreatedDateTime": "2026-09-22T09:44:55Z",
      "equipmentEventTypeCode": "DISC",
      "equipmentReference": "FCIU4892369",
      "emptyIndicatorCode": "LADEN",
      "documentReferences": [
        {
          "documentReferenceType": "TRD",
          "documentReferenceValue": "HDMU1234567890"
        }
      ],
      "transportCall": {
        "transportCallID": "bbec06f4-24fd-5a7f-9bd9-dba9c63e217a",
        "modeOfTransport": "VESSEL",
        "location": {
          "locationName": "Southampton",
          "UNLocationCode": "GBSOU"
        },
        "vessel": {
          "vesselIMONumber": "9637234",
          "vesselName": "HYUNDAI HOPE"
        },
        "carrierVoyageNumber": "0058W"
      },
      "modaltrans": {
        "systemStatus": "dischargeFromVessel",
        "carrierEventCode": "DISC",
        "carrierEventDescription": "Vessel Discharged at POD",
        "vesselName": "HYUNDAI HOPE",
        "carrierCode": "HDMU",
        "eventKey": "32aa1788-48ca-5ecc-bab8-d4c97a7c5d41",
        "loadingReference": "SWSIM0033518"
      }
    }
  ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://your-api-server.com' \
--header 'X-Modaltrans-Signature: sha256=d55e674078099a696aebbcb1c4e0094a938fd7902667c8d06de366bcdfcc2741' \
--header 'X-Modaltrans-Delivery: 56c9977c-8aed-4d84-839e-1c195bf13a1f' \
--header 'X-Modaltrans-Event: sea_tracking_events/create' \
--header 'User-Agent: Modaltrans-Webhook/1.0' \
--header 'Content-Type: application/json' \
--data '{
  "webhookId": 12,
  "eventName": "sea_tracking_events/create",
  "deliveryId": "56c9977c-8aed-4d84-839e-1c195bf13a1f",
  "sentAt": "2026-09-22T09:44:55Z",
  "data": [
    {
      "eventID": "681e6e97-0fdb-5043-a287-3855485e1cb1",
      "eventType": "EQUIPMENT",
      "eventClassifierCode": "ACT",
      "eventDateTime": "2026-09-21T17:00:00Z",
      "eventCreatedDateTime": "2026-09-22T09:44:55Z",
      "equipmentEventTypeCode": "DISC",
      "equipmentReference": "FCIU4892369",
      "emptyIndicatorCode": "LADEN",
      "documentReferences": [
        {
          "documentReferenceType": "TRD",
          "documentReferenceValue": "HDMU1234567890"
        }
      ],
      "transportCall": {
        "transportCallID": "bbec06f4-24fd-5a7f-9bd9-dba9c63e217a",
        "modeOfTransport": "VESSEL",
        "location": {
          "locationName": "Southampton",
          "UNLocationCode": "GBSOU"
        },
        "vessel": {
          "vesselIMONumber": "9637234",
          "vesselName": "HYUNDAI HOPE"
        },
        "carrierVoyageNumber": "0058W"
      },
      "modaltrans": {
        "systemStatus": "dischargeFromVessel",
        "carrierEventCode": "DISC",
        "carrierEventDescription": "Vessel Discharged at POD",
        "vesselName": "HYUNDAI HOPE",
        "carrierCode": "HDMU",
        "eventKey": "32aa1788-48ca-5ecc-bab8-d4c97a7c5d41",
        "loadingReference": "SWSIM0033518"
      }
    }
  ]
}'

Responses

🟢204Accepted

Return any 2xx once you have stored the body. Process it afterwards. Any other status, a timeout or a connection failure is retried after 1, 5 and 10 minutes.

This response does not have a body.

Modified at 2026-09-25 15:35:25

Tracking Webhooks

Sea Tracking Event Updated