Trackuar API Documentation

Complete reference for mobile and web developers building on Trackuar. Base production domain is https://trackuar.cfd.

Base URL: https://trackuar.cfd/api

Authentication API

OTP email login flow used by the Flutter app and partner clients.

POST /auth/api/request-otp/
{ "email": "admin@trackuar.com" }
POST /auth/api/verify-otp/
{ "email": "admin@trackuar.com", "otp_code": "123456" }
GET /auth/api/me/
Authorization: Bearer <access_token>

Companies API

Create and manage companies, addresses, contacts, and verification status.

POST/companies/api/register/
GET/companies/api/my-companies/
GET/companies/api/companies/{id}/
PUT/companies/api/companies/{id}/
DELETE/companies/api/companies/{id}/
POST/companies/api/companies/{id}/verify/
POST/companies/api/companies/{id}/addresses/
DELETE/companies/api/addresses/{id}/
POST/companies/api/companies/{id}/contacts/
DELETE/companies/api/contacts/{id}/

Shipments API

Transports, parcels, status updates, public tracking and dashboard summary.

GET/shipments/api/transports/
GET/shipments/api/transports/{id}/
POST/shipments/api/company/transports/create/
POST/shipments/api/company/transports/{id}/batch-status/
POST/shipments/api/parcels/create/
GET/shipments/api/parcels/my/
GET/shipments/api/parcels/{id}/
POST/shipments/api/parcels/{id}/status/
GET/shipments/api/track/{tracking}/
GET/shipments/api/dashboard/summary/
GET/shipments/api/dashboard/transports/
GET/shipments/api/company/parcels/

Communications API

Conversations, messages, broadcasts and user notifications.

POST/communications/api/conversations/start/
GET/communications/api/conversations/user/
GET/communications/api/conversations/company/
GET/communications/api/conversations/{id}/
POST/communications/api/messages/send/
POST/communications/api/messages/mark-read/{conversationId}/
POST/communications/api/broadcasts/create/
GET/communications/api/broadcasts/
GET/communications/api/notifications/
POST/communications/api/notifications/{id}/read/

Test Data

Pre-seeded local credentials and sample shipment data.

Admin: admin@trackuar.com / Admin@12345
Demo user: demo@trackuar.com / Demo@12345
Sample tracking: TRK-PA-DEMO1234
Local API base: http://127.0.0.1:8000/api
Production API base: https://trackuar.cfd/api