List public car rental vehicles (v1)

Method & Path

GET /api/v1/public/:workspaceSlug/carrental/vehicles

Actual path: /v1/public/:workspaceSlug/carrental/vehicles

Description

List vehicles for a car rental workspace. Workspace is resolved by workspaceSlug (must match publicSlug in carrental-settings).

Authentication

None – Public endpoint.

Path parameters

Parameter	Type	Required	Description
workspaceSlug	string	Yes	Public slug from carrental-settings (e.g. demo-rentals).

Query parameters

Parameter	Type	Required	Description
status	string	No	Filter: AVAILABLE, RESERVED, RENTED, MAINTENANCE.
branchId	string	No	Filter by branch ID.
categoryId	string	No	Filter by vehicle category ID.
page	number	No	Page (1-based).
limit	number	No	Page size.

Response 200 OK

{
  "items": [
    {
      "id": "...",
      "brand": "Toyota",
      "model": "Corolla",
      "year": 2023,
      "plateNumber": "ABC-123",
      "color": "White",
      "transmission": "AUTO",
      "fuelType": "GAS",
      "seats": 5,
      "dailyPrice": 150,
      "status": "AVAILABLE",
      "specs": {},
      "photos": [{ "url": "https://...", "createdAt": "..." }]
    }
  ],
  "total": 10,
  "page": 1,
  "limit": 20
}

Common errors

• 404: Car rental not found for this slug.
• 500: Server error.