# Rentalcars Supplier Ratings API Documentation

<p>Get the ratings of the suppliers that have offers for the search. This is the supplier rating at the depot level of the search. It is not the depot_rating on a single offer, which rates one pickup depot only. An empty list is a 200 response and is not billed. The market (cor) and the currency decide the prices. The response echoes both values in the market object. Scrappa is not affiliated with Rentalcars.com. This is an unofficial API.</p>

- **Documentation:** [https://scrappa.co/docs/rentalcars-api/rentalcars_supplier_ratings](https://scrappa.co/docs/rentalcars-api/rentalcars_supplier_ratings)
- **API group:** Rentalcars API
- **Endpoint:** `GET https://scrappa.co/api/rentalcars/supplier-ratings`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `pickup_location` | string | Yes | Pickup place. A 3-letter IATA airport code or "lat,lng". Example: BER. |
| `dropoff_location` | string | No | Dropoff place. Same format as the pickup place. Default: the pickup place. |
| `pickup_date` | string | Yes | Pickup date in Y-m-d format. It must not be in the past. Example: 2026-12-01. |
| `pickup_time` | string | No | Pickup time in H:i format. Default: 10:00. |
| `dropoff_date` | string | Yes | Dropoff date in Y-m-d format. It must not be before the pickup date. |
| `dropoff_time` | string | No | Dropoff time in H:i format. Default: 10:00. |
| `drivers_age` | integer | No | Age of the driver, from 18 to 99. Default: 30. |
| `cor` | string | No | Country of residence as a 2-letter code, or auto. It sets the market and the prices. With auto no market is sent and the offers follow the exit country. Use auto when you want to pass the search_key and vehicle_id to /terms. Default: gb. |
| `currency` | string | No | Currency code for prices. Default: EUR. |

## Example response

```json
{
    "meta": {
        "attempts": 1,
        "duration_ms": 3,
        "endpoint_family": "supplier_ratings"
    },
    "ratings": [
        {
            "scope": "supplier_at_depot",
            "score": 8.2,
            "depot_id": "4736942",
            "categories": [
                {
                    "label": "Value for money",
                    "rating": 7.2
                },
                {
                    "label": "Car cleanliness",
                    "rating": 8.3
                },
                {
                    "label": "Directions to counter",
                    "rating": 8.2
                }
            ],
            "depot_name": "Berlin Brandenburg Airport Willy Brandt",
            "offer_count": 1,
            "supplier_id": "207",
            "rating_label": "Very good",
            "supplier_name": "Sixt",
            "review_count_label": "400+ reviews"
        },
        {
            "scope": "supplier_at_depot",
            "score": 7.7,
            "depot_id": "4490007",
            "categories": [
                {
                    "label": "Value for money",
                    "rating": 7.3
                },
                {
                    "label": "Car cleanliness",
                    "rating": 7.3
                },
                {
                    "label": "Directions to counter",
                    "rating": 8
                }
            ],
            "depot_name": "Berlin Brandenburg Airport Willy Brandt",
            "offer_count": 2,
            "supplier_id": "227",
            "rating_label": "Good",
            "supplier_name": "Thrifty",
            "review_count_label": "100+ reviews"
        },
        {
            "scope": "supplier_at_depot",
            "score": 7.5,
            "depot_id": "4829006",
            "categories": [
                {
                    "label": "Value for money",
                    "rating": 7
                },
                {
                    "label": "Car cleanliness",
                    "rating": 8.3
                },
                {
                    "label": "Directions to counter",
                    "rating": 7.7
                }
            ],
            "depot_name": "Berlin Brandenburg Airport Willy Brandt",
            "offer_count": 1,
            "supplier_id": "17",
            "rating_label": "Good",
            "supplier_name": "Alamo",
            "review_count_label": "900+ reviews"
        }
    ],
    "search_parameters": {
        "engine": "rentalcars_supplier_ratings",
        "market": "gb",
        "currency": "EUR",
        "drivers_age": 30,
        "rental_days": 3,
        "pickup_datetime": "2026-11-08T10:00:00",
        "pickup_location": "BER",
        "dropoff_datetime": "2026-11-11T10:00:00",
        "dropoff_location": "BER",
        "pickup_location_type": "IATA",
        "dropoff_location_type": "IATA"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. No request is made upstream. Not billed. |
| 422 | Request Rejected | Rentalcars rejected the search values, for example a filter value that is not in available_filters. Not billed. |
| 503 | Rentalcars Temporarily Unavailable | Rentalcars did not answer in time. Retry after a short pause. Other 503 codes start with rentalcars_ too, for example rentalcars_invalid_response. Not billed. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)