Trackers

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

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": "2019-10-13",
  "displayable_expected_delivery_datetime": null,
  "displayable_expected_delivery_kind": "carrier",
  "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",
    "id": 12345,
    "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": {
          "en": "Out for delivery",
          "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": {
          "en": "Origin Scan",
          "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",
              "support_cced": null
            }
          ]
        },
        "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,
      "canceled": false,
      "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
      }
    ]
  },
  "claims": {
    "object": "list",
    "data": [

    ]
  }
}