List Stations

Retrieve a paginated list of all stations (pickup/dropoff locations) managed by the agency. Stations are physical locations where vehicles are parked and where clients can start and end their rentals.

Each station entry includes:

• Location Details: Name, address, and GPS coordinates
• Agency Assignment: Which agency manages this station
• Vehicle Counts: Total vehicles and currently available vehicles
• Operational Status: Whether the station is active or inactive

This endpoint is commonly used for:

• Managing the station network in the dashboard
• Monitoring vehicle distribution across locations
• Identifying stations with low availability
• Planning fleet rebalancing operations

Endpoint

INFO

GET /api/v1/dashboard/stations

Headers

Header	Value	Required
Accept	application/json	Yes
Authorization	Bearer {token}	Yes

Query Parameters

Parameter	Type	Default	Description
agency_id	integer	-	Filter by agency
search	string	-	Search by name or address
status	string	-	Filter: active, inactive
page	integer	1	Page number
per_page	integer	15	Items per page

Example Request

curl -X GET "https://api.daakey.com/api/v1/dashboard/stations?agency_id=1" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {token}"

Response

Success (200)

{
  "success": true,
  "message": "Stations retrieved",
  "data": [
    {
      "id": 1,
      "name": "Downtown Station",
      "address": "123 Main St, New York, NY",
      "latitude": 40.7128,
      "longitude": -74.0060,
      "agency": {
        "id": 1,
        "name": "Downtown Agency"
      },
      "status": "active",
      "vehicles_count": 12,
      "available_vehicles": 8,
      "created_at": "2024-01-01T00:00:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 15,
    "total": 1
  },
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}