# Tracking Update

A webhook that is triggered when one or more tracking updates are received from the carrier.

Endpoint: POST TrackingUpdate
Version: 2026.1

## Request fields (application/json):

  - `event_type` (string, required)
    The type of event that triggered the webhook.
    Example: tracking_update

  - `event_id` (string, required)
    A unique identifier for the event.
    Example: AB12C3

  - `payload_version` (string, required)
    The version of the payload schema.
    Example: 2026.1

  - `carrier_slug` (string)
    The slug of the carrier that provided the tracking update.
    Example: dhl

  - `count` (integer)
    The number of packages (tracking updates) in the response.
    Example: 1

  - `trackings` (array)

  - `trackings.tracking_number` (string, required)
    The tracking number of the package the tracking update is associated with.
    Example: JD014600003281234567

  - `trackings.consignment_identifier` (string, required)
    The identifier of the consignment.
    Example: ab12345

  - `trackings.consignment_number` (string, required)
    The consignment number of the consignment.
    Example: 000000000008108293

  - `trackings.order_number` (string, required)
    The order number of the consignment.
    Example: order-12345

  - `trackings.id` (integer, required)
    The internal parcel identifier from our tracking system.
    Example: 1234567890

  - `trackings.carrier` (string, required)
    The name of the carrier who provided this tracking update.
    Example: DHL

  - `trackings.events` (array, required)

  - `trackings.events.status` (string, required)
    The status Scurri assigns to the tracking event.
    Example: DELIVERED

  - `trackings.events.description` (string)
    A description of the tracking event.
    Example: The package was delivered to the recipient.

  - `trackings.events.timestamp` (string, required)
    The timestamp when the tracking event occurred.
    Example: 2025-10-01T14:30:00

  - `trackings.events.carrier_code` (string)
    The event code provided by the carrier.
    Example: EVD

  - `trackings.events.location` (string)
    The location where the event took place.
    Example: London