Events method

POST /sis/v1/AddEvent

Uri parameters

None

Body parameters

Name Description Type Additional description
observationCode The type of event, e.g: 'AE' String Required
additionalCode The additional code for the event, e.g: 'E' String
timestamp The timestamp of the event String Required
parcelNumber The parcel number for the event. Either ParcelNumber or ShipmentNumber must be provided. String
shipmentNumber The shipment number for the event. Either ShipmentNumber or ParcelNumber must be provided. String
location None
dimensions None
signature None
proofOfDelivery Proof of delivery as a base64 string, a photo of the delivered parcel. Must be a Base64 encoded Data URI. Format: data:image/{type};base64,{data} String
containerNumber The container number for the event, if available String

Request sample:

{
  "observationCode": "AE",
  "additionalCode": "E",
  "timestamp": "2026-06-24T01:55:52.2823745+02:00",
  "parcelNumber": "370726545000000170",
  "shipmentNumber": "70726540000000360",
  "location": {
    "lat": 59.9286101,
    "long": 10.835933
  },
  "dimensions": {
    "length": 30,
    "width": 20,
    "height": 10,
    "weight": 2.5,
    "volume": 6
  },
  "signature": {
    "signatureImage": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==",
    "signatureName": "Ola Nordmann"
  },
  "proofOfDelivery": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==",
  "containerNumber": ""
}

Response sample:

400

{
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "title": "One or more validation errors occured",
  "state": 400,
  "traceId": null,
  "errors": {
    "request": [
      "The parcel number cannot be empty"
    ]
  }
}

401

Unauthorized

403

Forbidden