# FellaHost Company Limited
**Project Developers & Software Engineering Specialists**  
**Document Reference:** Section 24 Deliverables for Software Development Team  
**System Designation:** Integrated Clearing, Forwarding & Logistics System (ICFLS)  
**Corporate Entity:** FellaHost Company Limited  
**TIN NO:** 189-723-717 | **B.L.No:** 20000105272  
**Headquarters:** P.O. Box 80079, Dar es Salaam, Tanzania  
**Support Desk:** support@fellahost.co.tz | **Web:** www.fellahost.co.tz  
**System Deployment Host:** `logistics.domain.co.tz` | `api.domain.co.tz`  
**Publication Date:** September 2026 | **Version:** 1.0 (Production Master Engineering Pack)  

---
# 6. Internal & External API Specification (OpenAPI 3.1)

## Executive Overview
The ICFLS API provides RESTful endpoints on `https://api.domain.co.tz` for customer tracking portals, telematics GPS hardware ingestion, TRA TANCIS customs integration, and corporate accounting synchronization.

---

## 6.1 Authentication & Security Architecture
- **Standard**: Bearer Token Authentication via Laravel Sanctum (OAuth2 compliant).
- **Transport**: TLS 1.3 encryption required on all requests.
- **Rate Limiting**: 60 requests/minute for standard tier; 1,000 requests/minute for internal telemetry pipelines.

---

## 6.2 Key Endpoint Specifications

### 6.2.1 Real-Time Consignment Tracking
- **Endpoint**: `GET /api/v1/track/{reference}`
- **Authentication**: Public (Rate-limited to 30 req/min per IP)
- **Response Format (JSON)**:
```json
{
  "status": "success",
  "data": {
    "job_number": "ICFLS-2026-0941",
    "tracking_ref": "MEDU9918234",
    "customer": "Mega Mining Corporation Ltd",
    "cargo": "Heavy Mining Extraction Machinery",
    "status": "In_Transit",
    "current_stage": "En Route to Tunduma Border",
    "milestones": [
      {
        "stage": "Vessel Discharged",
        "location": "Dar es Salaam Port Berth 4",
        "completed_at": "2026-09-24T10:14:00Z"
      },
      {
        "stage": "Customs Release",
        "location": "TRA TANCIS Desk",
        "completed_at": "2026-09-26T16:30:00Z"
      },
      {
        "stage": "Corridor Haulage Dispatched",
        "location": "Dar es Salaam Depot",
        "completed_at": "2026-09-27T08:00:00Z"
      }
    ],
    "telemetry": {
      "latitude": -8.9142,
      "longitude": 33.4521,
      "speed_kmh": 58,
      "last_ping": "2026-09-29T08:45:00Z"
    }
  }
}
```

### 6.2.2 GPS Telematics Telemetry Ingestion
- **Endpoint**: `POST /api/v1/trips/{trip_number}/telemetry`
- **Authentication**: Bearer Token (Fleet Telematics Scope)
- **Payload**:
```json
{
  "latitude": -8.914210,
  "longitude": 33.452140,
  "speed_kmh": 58.5,
  "heading": "SW",
  "engine_status": "Running",
  "fuel_level_percent": 74.2,
  "recorded_at": "2026-09-29T08:45:00Z"
}
```

---

### Regulatory Notice
> **We're Top leading Company Registering under Commercial & Technical ICT Services TIN NO: 189-723-717**  
> *FellaHost Company Limited — Project Developers & Engineering Specialists.*  
> *Confidential & Proprietary Enterprise Asset — All Rights Reserved.*