wacaDevelopers

API reference · Rentals

Reviews

What customers say about a car, with its average rating. A customer reviews the car after the rental is returned (or the purchase is complete), and a review counts for that car only.

get/rentals/vehicles/{id}/reviews

Reviews of a rental car

The published reviews of one car, newest first, with the average and how many reviews gave each number of stars. Customers can review only after the rental is returned, once per rental, and a review counts for that car alone. Cars with good reviews are listed first by default.

Path parameters

  • idintegerrequired

    The car’s id.

    Example: 12

Query parameters

  • pageinteger

    Page number, from 1.

    Example: 1

  • limitinteger

    Items per page (1–100). Default 20.

    Example: 20

Response 200

A page: { data: [ … ], page, totalPages, total }. Each item in data:

  • ratingintegerrequired

    1 to 5 stars.

  • titlestring · nullable
  • commentstring · nullable
  • namestringrequired

    The first name and the first letter of the last name.

  • kindenum

    rentalpurchase

  • createdAtdate-timerequired

    ISO 8601 date-time.

Errors

  • 401unauthorized: the API key is missing, wrong or revoked.
  • 404not_found: no such thing, or it is not yours.
curl "https://engine-production-0004.up.railway.app/api/v1/rentals/vehicles/12/reviews?page=1&limit=20" \
  -H "Authorization: Bearer wc_test_YOUR_KEY"
Response · 200
{
  "summary": {
    "average": 4.7,
    "count": 3,
    "distribution": {
      "1": 0,
      "2": 0,
      "3": 0,
      "4": 1,
      "5": 2
    }
  },
  "data": [
    {
      "rating": 5,
      "title": "Spotless",
      "comment": "Clean car, easy pick-up at the airport.",
      "name": "Chidi E.",
      "kind": "rental",
      "createdAt": "2026-11-24T09:00:00.000Z"
    }
  ],
  "page": 1,
  "totalPages": 1,
  "total": 3
}
get/sales/vehicles/{id}/reviews

Reviews of a car for sale

The reviews of the car behind a sale listing: they belong to the car, whether people rented it or bought it.

Path parameters

  • idintegerrequired

    The sale listing’s id.

    Example: 31

Query parameters

  • pageinteger

    Page number, from 1.

    Example: 1

  • limitinteger

    Items per page (1–100). Default 20.

    Example: 20

Response 200

A page: { data: [ … ], page, totalPages, total }. Each item in data:

  • ratingintegerrequired

    1 to 5 stars.

  • titlestring · nullable
  • commentstring · nullable
  • namestringrequired

    The first name and the first letter of the last name.

  • kindenum

    rentalpurchase

  • createdAtdate-timerequired

    ISO 8601 date-time.

Errors

  • 401unauthorized: the API key is missing, wrong or revoked.
  • 404not_found: no such thing, or it is not yours.
curl "https://engine-production-0004.up.railway.app/api/v1/sales/vehicles/31/reviews?page=1&limit=20" \
  -H "Authorization: Bearer wc_test_YOUR_KEY"