FleetBoss 360 API Documentation
Developer guide for integrating with FleetBoss 360 REST API.
🔌 API Overview
Base Information
Base URL
https://fb.ramnova.in/api/v1
Content Type
application/json
Authentication
All API requests require authentication using Bearer tokens.
Authorization: Bearer YOUR_API_TOKEN🚗 Vehicle Endpoints
GET
/vehicles
Retrieve all vehicles in your fleet.
Example Response:
{
"data": [
{
"id": 1,
"vehicle_number": "FL001",
"make": "Toyota",
"model": "Hiace",
"year": 2023,
"status": "active",
"current_location": {
"latitude": 28.6139,
"longitude": 77.2090
}
}
],
"meta": {
"total": 1,
"per_page": 15,
"current_page": 1
}
}
POST
/vehicles
Add a new vehicle to your fleet.
Request Body:
{
"vehicle_number": "FL002",
"make": "Honda",
"model": "City",
"year": 2023,
"license_plate": "DL01AB1234",
"fuel_type": "petrol",
"status": "active"
}📍 Tracking Endpoints
GET
/vehicles/{id}/location
Get real-time location of a specific vehicle.
Example Response:
{
"vehicle_id": 1,
"latitude": 28.6139,
"longitude": 77.2090,
"speed": 45.5,
"heading": 180,
"timestamp": "2024-01-15T10:30:00Z",
"address": "Connaught Place, New Delhi"
}
GET
/vehicles/{id}/trips
Retrieve trip history for a vehicle.
Query Parameters:
from- Start date (YYYY-MM-DD)to- End date (YYYY-MM-DD)page- Page number (default: 1)
⛽ Fuel Management Endpoints
POST
/fuel-logs
Record a fuel purchase/consumption entry.
Request Body:
{
"vehicle_id": 1,
"quantity": 45.5,
"cost_per_liter": 82.50,
"total_cost": 3753.75,
"odometer_reading": 15250,
"fuel_station": "Indian Oil Station",
"date": "2024-01-15"
}⚠️ Error Codes
HTTP Status Codes
200- Success201- Created400- Bad Request401- Unauthorized403- Forbidden404- Not Found500- Server Error
Error Response Format
{
"error": {
"code": "VALIDATION_ERROR",
"message": "The given data was invalid.",
"details": {
"vehicle_number": [
"This field is required."
]
}
}
}