---
updatedAt: 2025-04-24T20:28:06.000Z
agentTools:
  projectIndex: https://api-docs.shippedsuite.com/llms.txt
---

# /v1/trackers/{external_id}

Returns a specific Tracker

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Shipped Suite API",
    "description": "API provides access to Shipped Suite functions",
    "contact": {
      "name": "Steven Ou",
      "email": "steven@invisiblecommerce.com"
    },
    "version": "v1"
  },
  "servers": [
    {
      "url": "//api.shippedsuite.com/"
    }
  ],
  "security": [
    {
      "secretKey": []
    }
  ],
  "tags": [
    {
      "name": "Trackers",
      "description": "Operations about Trackers"
    }
  ],
  "paths": {
    "/v1/trackers/{external_id}": {
      "get": {
        "tags": [
          "Trackers"
        ],
        "description": "Returns a specific Tracker",
        "operationId": "getV1TrackersExternalId",
        "parameters": [
          {
            "name": "external_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Returns a specific Tracker",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Tracker"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Courier": {
        "required": [
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Courier name",
            "example": "FedEx"
          },
          "display_name": {
            "type": "string",
            "description": "Alternate courier display name",
            "example": "FedEx"
          },
          "phone": {
            "type": "string",
            "description": "Courier's phone number",
            "example": "1 800 463 3339"
          },
          "url": {
            "type": "string",
            "description": "Courier's website URL",
            "example": "https://www.fedex.com/"
          }
        }
      },
      "TrackingEvent": {
        "required": [
          "code",
          "message",
          "status",
          "sub_message",
          "time"
        ],
        "type": "object",
        "properties": {
          "time": {
            "type": "string",
            "description": "Time at which the Tracking Event occurred",
            "format": "date-time"
          },
          "status": {
            "type": "string",
            "description": "Tracking Event status",
            "example": "InTransit"
          },
          "message": {
            "type": "string",
            "description": "Tracking Event status message",
            "example": "Departed USPS Regional Facility"
          },
          "sub_message": {
            "type": "string",
            "description": "Tracking Event sub-status message",
            "example": "Departure Scan"
          },
          "location": {
            "type": "string",
            "description": "Tracking Event location",
            "example": "SAN FRANCISCO CA DISTRIBUTION CENTER"
          },
          "city": {
            "type": "string",
            "description": "Tracking Event city",
            "example": "SAN FRANCISCO"
          },
          "state": {
            "type": "string",
            "description": "Tracking Event state",
            "example": "CA"
          },
          "zip": {
            "type": "string",
            "description": "Tracking Event zip",
            "example": "94134"
          },
          "code": {
            "type": "string",
            "description": "Tracking Event status code",
            "example": "T1"
          }
        }
      },
      "Tracker": {
        "required": [
          "courier",
          "created_at",
          "external_id",
          "status",
          "tracking_number",
          "updated_at"
        ],
        "type": "object",
        "properties": {
          "courier": {
            "type": "object",
            "description": "Courier information",
            "allOf": [
              {
                "$ref": "#/components/schemas/Courier"
              }
            ]
          },
          "tracking_number": {
            "type": "string",
            "description": "Tracking number",
            "example": "282287874772"
          },
          "tracking_url": {
            "type": "string",
            "description": "URL for courier tracking page",
            "example": "https://www.fedex.com/fedextrack/?trknbr=282287874772"
          },
          "status": {
            "type": "string",
            "description": "Current tracking status",
            "example": "shipped",
            "enum": [
              "processing",
              "shipped",
              "out_for_delivery",
              "delivered",
              "exception"
            ]
          },
          "location": {
            "type": "string",
            "description": "Last known tracking location",
            "example": "SACRAMENTO, CA"
          },
          "estimated_delivery": {
            "type": "string",
            "description": "The estimated date and time the package will be delivered. RFC 3339. ",
            "format": "date-time"
          },
          "shipped_at": {
            "type": "string",
            "description": "The date and time the package was shipped. RFC 3339. ",
            "format": "date-time"
          },
          "delivered_at": {
            "type": "string",
            "description": "The date and time the package was delivered. RFC 3339. ",
            "format": "date-time"
          },
          "events": {
            "type": "object",
            "description": "Detailed tracking events",
            "allOf": [
              {
                "$ref": "#/components/schemas/TrackingEvent"
              }
            ]
          },
          "external_id": {
            "type": "string",
            "description": "Unique ID of Tracker in partner platform",
            "example": "9849032"
          },
          "created_at": {
            "type": "string",
            "description": "The date and time the Tracker was created. RFC 3339. ",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "description": "The date and time the Tracker was last updated. RFC 3339. ",
            "format": "date-time"
          }
        },
        "description": "Tracker model"
      }
    },
    "securitySchemes": {
      "secretKey": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header"
      }
    }
  },
  "x-original-swagger-version": "2.0"
}
```