Station Details

Retrieve comprehensive information about a specific station, including its full address, operating hours, available amenities, and a list of all vehicles currently at that location.

This endpoint is used when:

• Displaying a station detail page after the user taps on a station
• Showing all vehicles available at a particular location
• Displaying station contact information and directions
• Checking operating hours before visiting

The response includes all vehicles at the station, making it easy to build a vehicle selection screen without additional API calls. Each vehicle entry includes basic information like brand, model, category, and pricing.

Endpoint

INFO

GET /api/v1/client/stations/{station}

Headers

Header	Value	Required
Accept	application/json	Yes
Authorization	Bearer {token}	Yes
X-Agency-Signature	{signature}	Yes

Path Parameters

Parameter	Type	Description
station	integer	Station ID

Example Request

curl -X GET https://api.daakey.com/api/v1/client/stations/1 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {token}" \
  -H "X-Agency-Signature: {signature}"

Response

Success (200)

{
  "success": true,
  "message": "Station retrieved",
  "data": {
    "id": 1,
    "name": "Downtown Station",
    "description": "Our flagship location in the heart of downtown, offering a wide selection of vehicles.",
    "address": "123 Main St, New York, NY 10001",
    "latitude": 40.7128,
    "longitude": -74.0060,
    "phone": "+1234567890",
    "email": "downtown@daakey.com",
    "images": [
      "https://api.daakey.com/storage/stations/1/image1.jpg",
      "https://api.daakey.com/storage/stations/1/image2.jpg"
    ],
    "operating_hours": {
      "monday": "06:00-22:00",
      "tuesday": "06:00-22:00",
      "wednesday": "06:00-22:00",
      "thursday": "06:00-22:00",
      "friday": "06:00-23:00",
      "saturday": "07:00-23:00",
      "sunday": "07:00-21:00"
    },
    "amenities": ["parking", "charging", "restroom", "wifi"],
    "vehicles": [
      {
        "id": 1,
        "brand": "Toyota",
        "model": "Corolla",
        "year": 2023,
        "category": "sedan",
        "status": "available",
        "hourly_rate": 15.00,
        "daily_rate": 80.00,
        "image": "https://api.daakey.com/storage/vehicles/1/thumb.jpg"
      },
      {
        "id": 2,
        "brand": "Honda",
        "model": "CR-V",
        "year": 2022,
        "category": "suv",
        "status": "available",
        "hourly_rate": 20.00,
        "daily_rate": 110.00,
        "image": "https://api.daakey.com/storage/vehicles/2/thumb.jpg"
      }
    ],
    "stats": {
      "total_vehicles": 12,
      "available_vehicles": 8,
      "categories": {
        "sedan": 5,
        "suv": 4,
        "compact": 3
      }
    }
  },
  "meta": {
    "agency_id": 123,
    "agency_code": "AGENCY123"
  },
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

Error (404)

{
  "success": false,
  "message": "Station not found",
  "data": null,
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

Notes

• Returns all available vehicles at the station
• Operating hours are in the station's local timezone