TrackingEvent

A location or tracking update derived from carrier communication.

  • eventSource
    enum
    required

    How the tracking data was obtained

    values
    • 4KITES
    • CARRIER_API
    • HIGHWAY
    • MACROPOINT
    • P44
  • eventType
    enum
    required

    Type of tracking event

    values
    • DELAYED
    • INFO
    • PICKED_UP
    • PING
    • DRIVER_AT_PICKUP
    • DRIVER_AT_DELIVERY
    • DELIVERED
    • COVERED
    • DISPATCHED
  • eventUtc
    required
    • Type: string · InputDateTimeUtcFormat: date-time

      Event time in UTC, or with a specific timezone offset

  • city
    Type: string
  • country
    Type: string
  • dispatcher
    Type: object

    Contact information for a person associated with a tracking event.

    • email
      Type: string

      Email address of the contact.

    • id
      Type: string

      Identifier of the contact in the TMS system.

    • name
      Type: string

      Full name of the contact.

    • phone
      Type: string

      Phone number in E.164 format (e.g., +12081234567) or common local format. Supports US, CA, MX, PH.

    • phoneExtension
      Type: string

      Phone number extension (numeric only).

  • driver
    Type: object

    Contact information for a person associated with a tracking event.

    • email
      Type: string

      Email address of the contact.

    • id
      Type: string

      Identifier of the contact in the TMS system.

    • name
      Type: string

      Full name of the contact.

    • phone
      Type: string

      Phone number in E.164 format (e.g., +12081234567) or common local format. Supports US, CA, MX, PH.

    • phoneExtension
      Type: string

      Phone number extension (numeric only).

  • eventCode
    Type: stringenum

    Optional EDI 214 tracking status code.

    values
    • AA
    • AB
    • AF
    • AG
    • AM
  • eventLocalTime
    • Type: string · InputDateTimeUtcFormat: date-time

      Local time of the event, in the timezone of the event.

  • latitude
    Type: number
  • longitude
    Type: number
  • nextEtaUtc
    • Type: string · InputDateTimeUtcFormat: date-time

      Next estimated arrival time in UTC, or with a specific timezone offset

  • nextSequence
    Type: integer

    Next stop sequence number

  • notes
    Type: string

    Free-text context from the carrier communication

  • postalCode
    Type: string
  • stateOrProvince
    Type: string
  • temperatureF
    Type: number

    Temperature in Fahrenheit (if available)