Developer Portal

Everything you need to integrate TrackLogy into your application.

Quick Start

Create an account at my.tracklogy.com (opens in a new tab) — free 14-day trial, no credit card required.
Get your API key — go to Settings → API Keys and generate a key with the scopes you need.
Make your first call — add a shipment or query a tracking status:

curl -X POST https://api.tracklogy.com/v1/api/shipments \
  -H "X-API-Key: tlg_your_key" \
  -H "Content-Type: application/json" \
  -d '{"tracking_number": "1Z999AA10123456784", "store_name": "My Store"}'

Base URL

https://api.tracklogy.com/v1

All endpoints return JSON with the envelope:

{ "success": true, "data": { ... }, "message": "" }

On error:

{ "success": false, "error": { "code": 422, "message": "tracking_number is required" } }

Authentication

Send your API key as the X-API-Key request header on every authenticated request:

X-API-Key: tlg_your_api_key_here

Public endpoints (carrier detection, plan listing) require no authentication.

Rate Limits

Header	Description
`X-RateLimit-Limit`	Maximum requests allowed in the current window
`X-RateLimit-Remaining`	Requests remaining in the current window
`X-RateLimit-Reset`	Unix timestamp when the window resets

Default: 600 requests per 10 minutes per API key.

Key Endpoints

Shipments

Method	Path	Description
`GET`	`/api/shipments`	List all shipments
`POST`	`/api/shipments`	Create one or more shipments
`GET`	`/api/shipments/show`	Get tracking status for a shipment
`PUT`	`/api/shipments/update`	Update a shipment
`DELETE`	`/api/shipments/delete`	Delete a shipment

Carriers

Method	Path	Description
`GET`	`/api/carriers`	List all 900+ supported carriers
`POST`	`/public/carriers/detect`	Detect carrier from tracking number (no auth)

Machine-Readable Resources

Resource	URL
OpenAPI 3.1 Specification	/openapi.json (opens in a new tab)
MCP Manifest	/.well-known/mcp/manifest.json (opens in a new tab)
LLM index	/llms.txt (opens in a new tab)
Sitemap	/sitemap.xml (opens in a new tab)

MCP / AI Agent Integration

TrackLogy exposes its API as Model Context Protocol (MCP) (opens in a new tab) tools, letting Claude, ChatGPT, and other AI agents call the platform natively.

MCP server endpoint: https://api.tracklogy.com/mcp
Manifest: https://docs.tracklogy.com/.well-known/mcp/manifest.json

Available tools: track_shipment, create_shipment, detect_carrier, list_carriers, list_shipments.

Webhooks

TrackLogy sends a POST request to your configured URL on every tracking status change. See the Webhooks reference for the full payload schema and delivery guarantees.

SDKs & Code Generation

The OpenAPI 3.1 spec (opens in a new tab) is compatible with:

openapi-generator — generate a client in 50+ languages
Speakeasy — TypeScript, Python, Go SDK generation
Postman — import for interactive testing

Versioning Policy

URL path versioning: /v1, /v2, etc. Minimum 12-month deprecation notice with Sunset and Deprecation headers on deprecated endpoints (RFC 8594).

Full policy: tracklogy.com/legal/api-versioning (opens in a new tab)

Support

Documentation: docs.tracklogy.com (opens in a new tab)
Email: [email protected]
Dashboard: my.tracklogy.com (opens in a new tab)

FAQ