GET /v2/trackers

You can list all trackers or a subset of them with specific parameters (see below). The trackers are returned sorted by ID in descending order.

Along with relationships described in Shipup core resources, you can expand all events related to the trackers.

Parameters:

PARAMETER

DESCRIPTION

tracking_number
string, optional

Only return the trackers with this tracking number

created_at
datetime or object, optional

A filter on the list based on the object created_at field. The value can be a string with an integer Unix timestamp, or it can be an object with the following options:
created_at[gt]: created_at field is greater than this value
created_at[gte]: created_at field is greater than or equal to this value
created_at[lt]: created_at field is less than this value
created_at[lte]: created_at field is less than or equal to this value

curl --location -g --request GET "https://api.shipup.co/v2/trackers?expand[]=fulfillment.order.shipping_address&expand[]=fulfillment.order.line_items&expand[]=fulfillment.shipping_address&expand[]=fulfillment.line_items&expand[]=events.address&expand[]=line_items&expand[]=carrier&expand[]=notifications.notification_payloads&expand[]=notifications.notification_type" \
--header "Authorization: ${PRIVATE_KEY}" \
--header "Content-Type: application/json"
// status code
200

// body
{
  "object": "tracker",
  "id": 12345,
  "created_at": 1570906800,
  "custom_variables": null,
  "delivered_at": null,
  "delivery_status_code": "in_transit",
  "displayable_expected_delivery_date": null,
  "displayable_expected_delivery_datetime": null,
  "first_delivery_attempted_at": null,
  "mute_notifications": false,
  "shipped_at": null,
  "tracking_link": "http://www.laposte.fr/outils/suivre-vos-envois?code=AZERTYU123",
  "tracking_number": "AZERTYU123",
  "untracked_carrier_name": null,
  "untracked_carrier_url": null,
  "updated_at": null,
  "uuid": "6ac199f1-e1f7-41c0-b26a-a409a31e51f2",
  "carrier": {
    "object": "carrier",
    "code": "colissimo",
    "name": "Colissimo"
  },
  "carrier_service": {
    "object": "carrier_service",
    "code": "colissimo_express",
    "name": "Colissimo Express"
  },
  "events": {
    "object": "list",
    "data": [
      {
        "object": "event",
        "id": 12346,
        "event_type_code": null,
        "happened_at": 1570906800,
        "message": "Out for delivery",
        "raw": "{:matcher=>\"Out for delivery\", :date=>Sat, 12 Oct 2019 19:00:00 +0000}",
        "messages": {
          "fr": "Out for delivery"
        },
        "address": null
      },
      {
        "object": "event",
        "id": 12345,
        "event_type_code": "origin_scan",
        "happened_at": 1570906800,
        "message": "Package received",
        "raw": "{:message=>\"Package received\", :date=>Sat, 12 Oct 2019 19:00:00 +0000}",
        "messages": {
          "fr": "Scan d'entrée"
        },
        "address": null
      }
    ]
  },
  "notifications": {
    "object": "list",
    "data": [
      {
        "object": "notification",
        "id": 12345,
        "created_at": 1570906800,
        "language_code": "fr",
        "notification_payloads": {
          "object": "list",
          "data": [
            {
              "object": "notification_payload",
              "id": 12345,
              "created_at": 1570906800,
              "dispatched": false,
              "status": "built",
              "error": null,
              "type": "email"
            }
          ]
        },
        "notification_type": {
          "object": "notification_type",
          "id": 12345,
          "name": "Package delivered",
          "category": "package_delivered",
          "description": "The package was delivered to the recipient",
          "slug": "package_delivered"
        }
      }
    ]
  },
  "fulfillment": {
    "object": "fulfillment",
    "id": 12345,
    "created_at": null,
    "custom_variables": null,
    "estimated_delivery_range_end": null,
    "estimated_delivery_range_start": null,
    "fulfillment_number": "FULFILLMENT_NUMBER_1",
    "merchant_id": "FULFILLMENT_M_ID_1",
    "status_code": "shipped",
    "updated_at": null,
    "uuid": "365fc2b2-1c9e-476d-a911-6b73a59a4eec",
    "line_items": {
      "object": "list",
      "data": [

      ]
    },
    "order": {
      "object": "order",
      "id": 12345,
      "created_at": null,
      "custom_variables": null,
      "email": "[email protected]",
      "first_name": "Héloise",
      "language_code": "fr",
      "last_name": null,
      "merchant_id": "ORDER_M_ID_1",
      "mute_notifications": false,
      "order_number": "ORDER_NUMBER_1",
      "ordered_at": 1570906800,
      "phone": null,
      "updated_at": null,
      "uuid": "6c9d8ae1-1a67-4499-8018-0bb3bd4729b2",
      "line_items": {
        "object": "list",
        "data": [

        ]
      },
      "notifications": {
        "object": "list",
        "data": [

        ]
      },
      "shipping_address": {
        "object": "address",
        "id": 12345,
        "address1": "39 rue Beauregard",
        "address2": null,
        "city": "Paris",
        "comment": null,
        "company_title": null,
        "country": "France",
        "country_code": "FR",
        "first_name": "John",
        "last_name": "Doe",
        "name": "John Doe",
        "state": null,
        "zip": "75002"
      }
    },
    "shipping_address": {
      "object": "address",
      "id": 12345,
      "address1": "39 rue Beauregard",
      "address2": null,
      "city": "Paris",
      "comment": null,
      "company_title": null,
      "country": "France",
      "country_code": "FR",
      "first_name": "John",
      "last_name": "Doe",
      "name": "John Doe",
      "state": null,
      "zip": "75002"
    },
    "notifications": {
      "object": "list",
      "data": [

      ]
    }
  },
  "line_items": {
    "object": "list",
    "data": [
      {
        "object": "line_item",
        "id": 12347,
        "canceled": null,
        "canceled_quantity": null,
        "created_at": 1570906800,
        "custom_variables": null,
        "description": null,
        "merchant_id": "LINE_ITEM_M_UNFULFILLED_ID_3",
        "name": null,
        "quantity": null,
        "requires_shipping": null,
        "shipped_quantity": null,
        "sku": "LINE_ITEM_UNFULFILLED_SKU_3",
        "thumbnail": {
          "src": "https://imgurl.com/foo.jpg",
          "width": "300",
          "height": "100"
        },
        "title": null,
        "updated_at": 1570906800,
        "variant_title": null
      },
      {
        "object": "line_item",
        "id": 12346,
        "canceled": null,
        "canceled_quantity": null,
        "created_at": 1570906800,
        "custom_variables": null,
        "description": null,
        "merchant_id": "LINE_ITEM_M_UNFULFILLED_ID_2",
        "name": null,
        "quantity": null,
        "requires_shipping": null,
        "shipped_quantity": null,
        "sku": "LINE_ITEM_UNFULFILLED_SKU_2",
        "thumbnail": {
          "src": "https://imgurl.com/foo.jpg",
          "width": "300",
          "height": "100"
        },
        "title": null,
        "updated_at": 1570906800,
        "variant_title": null
      },
      {
        "object": "line_item",
        "id": 12345,
        "canceled": null,
        "canceled_quantity": null,
        "created_at": 1570906800,
        "custom_variables": null,
        "description": null,
        "merchant_id": "LINE_ITEM_M_UNFULFILLED_ID_1",
        "name": null,
        "quantity": null,
        "requires_shipping": null,
        "shipped_quantity": null,
        "sku": "LINE_ITEM_UNFULFILLED_SKU_1",
        "thumbnail": {
          "src": "https://imgurl.com/foo.jpg",
          "width": "300",
          "height": "100"
        },
        "title": null,
        "updated_at": 1570906800,
        "variant_title": null
      }
    ]
  }
}