Simple API

If you're working on a simple widget or tool the simple API is the easiest way to add a package. Redirect the user to this URL with the appropriate values:

http://www.usetrackthis.com/index/starttrack?pkgCode=123456
    &pkgName=iPod&pkgCarrier=auto

• pkgCode - Package tracking number, required
• pkgName - Nickname/label for the package, optional
• pkgCarrier - Package carrier code, required, defaults to 'auto'

If the user is logged in it will automatically add the package. If not, they will be prompted to log in and the package will be added after the login is complete.

---

Full API

Note: This API is for interacting with TrackThis and does not provide methods for retrieving package statuses directly from a carrier.

If you're interseted in building an application based on TrackThis, register your application

Authentication

Authentication for the API is handled through OAuth

Request token: http://www.usetrackthis.com/oauth/request-token

Authorize: http://www.usetrackthis.com/oauth/authorize

Access token: http://www.usetrackthis.com/oauth/access-token

List Packages

http://www.usetrackthis.com/api/list/

Add Package

http://www.usetrackthis.com/api/add/?pkgCode=STRING
   &pkgName=STRING&pkgCarrier=STRING&pkgDelivOnly=<1|0>

Edit Packages

http://www.usetrackthis.com/api/edit/?pkgId=INTEGER
   &pkgCode=STRING&pkgName=STRINGt&pkgCarrier=STRING&pkgDelivOnly=<1|0>

Delete Package

http://www.usetrackthis.com/api/delete/?pkgId=INTEGER

Package Carriers

Use carrier code in API calls for pkgCarrier, use carrier name when displaying to user. Carrier code 'auto' will try to auto detect the carrier when adding/editing and will save the true carrier code for the future. When listing packages if 'auto' is returned, the auto-detect failed and we are guessing on what the carrier is. Ideally the user would set the proper carrier.

Carrier Name	Carrier Code
Unknown Carrier	auto
UPS	UPS
USPS	USPS
DHL	DHL
Fedex	Fedex
Fedex Smartpost	fedexsp
TNT	tnt
Armaex	aramex
Canada Post	canadapost
CEVA	ceva
DHL Global Mail	dhlgm
DHL UK	dhluk
UK City Link	ukcl
UPS Mail Innovations	upsmi

Still have questions? Contact Us or post your feedback