Getting Started
Welcome to the Tower Crown Logistics Console API reference. Our APIs allow you to programmatically integrate global freight transportation, shipment routing, real-time tracking, automated pricing, and prepaid wallet services directly into your e-commerce platform, warehouse management system, or custom applications.
Why Integrate with Tower Crown?
- Real-Time Automated Dispatch: Instantly book cargo and courier services globally with a single HTTP request.
- Dynamic Pricing Engine: Accurate, distance-and-weight-based rate calculations with transparent cost breakdowns before booking.
- Low-Latency Tracking: Keep your customers updated via custom-branded tracking links and real-time webhook updates.
- Granular Custom Access Controls: Create multiple API keys with customizable roles and permissions tailored to different microservices or team members.
- Prepaid Virtual Wallet: Secure, isolated transaction processing. Top-up simulated funds in Sandbox or manage production deposits.
- Cryptographic Webhooks: Get notified instantly when shipment statuses transition, with end-to-end payload signature validation.
Environments
We offer two distinct environments, each using its own isolated database registry:
| Environment | Base URL | API Keys Prefix | Purpose |
|---|---|---|---|
| Sandbox | https://api.towercrownlogistics.com/v1 | tcl_sb_ | Testing, mock funding, transit simulation |
| Production | https://api.towercrownlogistics.com/v1 | tcl_live_ | Real-world shipments, actual billing |
Core Integration Flow
To successfully build your logistics integration, follow this step-by-step path:
- Register & Create Workspace: Sign up on the Tower Crown Developer Console and set up your workspace profile.
- Complete KYC Verification: Verify your business profile to transition from individual limits to full enterprise access.
- Configure Custom Roles: Define roles with granular permissions (e.g.,
shipments:write,wallet:read). - Generate API Keys: Create environment-specific credentials matching your services' access requirements.
- Fund Prepaid Wallet: Top up your wallet (Sandbox simulation is available instantly).
- Register Webhook Endpoint: Specify an HTTPS URL in your console to receive automated updates when shipment statuses transition.
- Start Booking: Call
POST /v1/shipmentsto register cargo bookings programmatically.