Tracking

List Tracked Shipments

GET /v1/tracking

Query Parameters

Param	Type	Description
`limit`	number	Max results (1-100, default 25)
`starting_after`	string	Cursor for forward pagination

Response

{
  "object": "list",
  "url": "/v1/tracking",
  "data": [
    {
      "object": "tracked_shipment",
      "id": 1,
      "tracking_number": "123456789",
      "carrier": "R+L Carriers",
      "status": "In Transit",
      "location": "Nashville, TN",
      "last_checked_at": "2025-07-01T12:00:00.000Z"
    }
  ],
  "has_more": false
}

Track a Shipment

POST /v1/tracking

Start tracking a shipment by PRO number.

Request Body

Field	Type	Required	Description
`tracking_number`	string	Yes	PRO number (1-50 chars)
`carrier`	string	No	Carrier name (default: auto-detect)

Example

curl -X POST https://api.freightcake.com/api/v1/tracking \
  -H "Authorization: Bearer fk_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "tracking_number": "123456789" }'

Get Tracking Details

GET /v1/tracking/:tracking_number

Returns current tracking status for a specific PRO number.

Refresh Tracking

POST /v1/tracking/:tracking_number/refresh

Force a fresh tracking status check from the carrier.

Stop Tracking

DELETE /v1/tracking/:tracking_number

Remove a shipment from active tracking.

On this page