Skip to main content

Tracking

Karrio exposes API endpoints that forwards tracking requests to the carrier's API.

Proxy Request API

The proxy APIs allow you to send tracking requests to carriers without creating any objects in karrio.

info

In that schenario, karrio is just a proxy that forward requests.

Get tracking details

GET /v1/proxy/tracking/{carrier_name}/{tracking_number}

You can use this endpoint to retrieve tracking details from the issuing carrier.

curl --request GET \
--url 'https://api.karrio.io/v1/proxy/tracking/fedex/774969848440' \
--header 'Authorization: Token [API_KEY]'

Trackers Management APIs

The trackers management APIs offer a set of endpoints around the karrio unified tracking details object.

Create a tracker

POST /v1/trackers/{carrier_name}/{tracking_number}

You can use this endpoint to create a tracker object in the karrio system and get the latest tracking details of the shipment.

tip

The karrio tracker is periodically updated by the karrio worker staying up to date with the package throughout it's journey.

curl --request GET \
--url 'https://api.karrio.io/v1/trackers/usps/9400111108435171104555' \
--header 'Authorization: Token [API_KEY]'

Next steps