Example tracker object
{
  "object": "tracker",
  "id": 830297390,
  "carrier_code": "dpd_fr",
  "custom_variables": {},
  "delivered_at": 1530183480,
  "displayable_expected_delivery_date": "2018-06-28", 
  "displayable_expected_delivery_datetime": 1530208800, 
  "delivery_status_code": "delivered",
  "first_delivery_attempted_at": 1530183480,
  "mute_notifications": false,
  "shipped_at": 1529595900,
  "tracking_link": "http://www.dpd.fr/traces_250059116919212260",
  "tracking_number": "250059116919212260",
  "carrier_tracker_identifier": "A29B-12IE_DAC8",
  "untracked_carrier_name": "DPD France",
  "untracked_carrier_url": "http://www.dpd.fr/traces_250059116919212260",
  "uuid": "6ac199f1-e1f7-41c0-b26a-a409a31e51f2",
  "created_at": 1529600912,
  "updated_at": 1529751762,
  "carrier": {
    "object": "carrier",
    "code": "dpd_fr",
    "name": "DPD France"
  },
  "carrier_service": {
    "object": "carrier_service",
    "id": 12345,
    "code": "colissimo_express",
    "name": "Colissimo Express"
  },
  "events": null,
  "fulfillment": null,
  "notifications": null,
  "line_items": null
}

A tracker represents a shipment handled by a shipping carrier. It must contain a tracking number and is generally generated when the shipping label is received from the carrier.

FIELDDESCRIPTION
id
integer
Unique identifier of the tracker
carrier_code
string
see available values
Code uniquely identifying a shipping carrier. Read the below section for more details
carrier_service_code
string
see available values
Code uniquely identifying a shipping carrier's delivery service. Should be used in association with the carrier_code field. Read the below section for more details
custom_variables
object
Object containing custom variables. Those variables can be reused to customize or add logic in the notifications
delivered_at
datetime
Time at which the tracker was delivered
displayable_expected_delivery_date
string, format is yyyy-mm-dd
Displayable expected delivery date for the package.

Shipup's data model includes different kinds of expected delivery dates (e.g. merchant expected delivery provided by the merchant or carrier expected delivery provided by the carrier). The displayable_expected_delivery_date corresponds to the first one available, in a configurable order. Visit your account's expected delivery
setting page
to change this configuration
displayable_expected_delivery_datetime
datetime
Displayable expected delivery date and time for the package. The time precision might not always be available, so prefer using the more robust displayable_expected_delivery_date attribute
delivery_status_code
string
see available values
Code uniquely identifying a shipping carrier
expected_delivery_at
datetime
Value provided by the merchant. This value represents the expected delivery date and time known by the merchant. This information makes sense at the tracker creation before the carrier starts handling the tracker.
first_delivery_attempted_at
datetime
Time at which the first carrier presentation was made, or time at which the package first reached a pickup point
mute_notifications
boolean
If set to true, no notification will be sent for this tracker. Defaults to false
shipped_at
datetime
Time at which the tracker was shipped by the carrier
tracking_link
string
Shipup generated URL redirecting to the delivery tracking on the shipping carrier's website
tracking_number
string
Package tracking number
carrier_tracker_identifier
string
Internal tracking number for carriers that require it
untracked_carrier_name
string
Carrier name to be displayed as a fallback if Shipup can't find a matching carrier
untracked_carrier_url
string
Carrier tracking URL to be displayed as a fallback if Shipup can't find a matching carrier
uuid
string
Unique identifier for the object, UUID format.
carrier
object, expandable
Carrier for this tracker. Object keys are:
carrier.object: string, value is "carrier"
carrier.code: string, carrier's code, see available values
carrier.name: string, carrier's name (only present if expanded)
events
list of events, expandable
List of shipping events for this tracker
fulfillment
fulfillment, expandable
Fulfillment this tracker is part of
line_items
list of line items, expandable
List of items shipped in this tracker
notifications
list of notifications, expandable
List of notifications sent for this tracker
created_at
datetime
Time at which the tracker was imported into Shipup
updated_at
datetime
Time at which the tracker was last updated

Carrier codes

Shipup will be adding carrier support overtime. You can read the carriers list to view those already available.
Shipup provides a carrier detection feature to automatically detect carriers depending on the tracking number. However, some carriers share tracking number patterns and the detection is thus error-prone. If you've correctly added the carriers used by your company to send your packages on the Setting Page, chances are that our algorithm will work. You can and should also manually provide a carrier_code in your requests to avoid any mistake.