# heycar Dealer Listings API Documentation

Retrieve a dealer on heycar, now Drive (drive.co.uk): name, address, phone, email, opening times, dealer group and listing count, plus a page of the dealer's current listings in the same shape as search. Page with the 0-based page and size parameters. An unknown dealer or a dealer without stock returns 404 NOT_FOUND and is not billed. UK stock only (GBP).

- **Documentation:** [https://scrappa.co/docs/heycar-api/heycar_dealer](https://scrappa.co/docs/heycar-api/heycar_dealer)
- **API group:** heycar API
- **Endpoint:** `GET https://scrappa.co/api/heycar/dealer`

## 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 |
| --- | --- | --- | --- |
| `dealer_id` | string | Yes | Numeric dealer id from the dealer.id field of a listing. Example: 7237. |
| `page` | integer | No | 0-based page number, 0 to 399. Defaults to 0. |
| `size` | integer | No | Listings per page, 1 to 50. Defaults to 20. |
| `sort` | string | No | Sort order: price-asc, price-desc, year-desc, mileage-asc, date-active-desc, relevance-desc or distance-asc. Omit for the default order. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/heycar/dealer?dealer_id=7237&page=0&size=20"
```

## Example response

```json
{
    "success": true,
    "data": {
        "dealer": {
            "id": "7237",
            "name": "Car Deal Warehouse Superstore Newbridge",
            "display_name": "Car Deal Warehouse Superstore Newbridge",
            "city": "Newbridge",
            "county": "Midlothian",
            "street": "Edinburgh's Luxury Car Village",
            "post_code": "EH288TH",
            "phone": "+443332416300",
            "email": "cardealwarehouse@easternholdings.co.uk",
            "opening_times": [
                {
                    "day_of_week": 1,
                    "open_from": "9:00",
                    "open_to": "18:00"
                },
                {
                    "day_of_week": 2,
                    "open_from": "9:00",
                    "open_to": "18:00"
                },
                {
                    "day_of_week": 3,
                    "open_from": "9:00",
                    "open_to": "18:00"
                },
                {
                    "day_of_week": 4,
                    "open_from": "9:00",
                    "open_to": "18:00"
                },
                {
                    "day_of_week": 5,
                    "open_from": "9:00",
                    "open_to": "18:00"
                },
                {
                    "day_of_week": 6,
                    "open_from": "9:00",
                    "open_to": "17:00"
                },
                {
                    "day_of_week": 7,
                    "open_from": "10:00",
                    "open_to": "15:00"
                }
            ],
            "dealer_group": {
                "id": "237",
                "name": "Eastern Western"
            },
            "listing_count": 149
        },
        "listings": [
            {
                "id": "16731596",
                "heycar_id": "volkswagen-golf-2016-14-tsi-125-match-edition-5dr-dsg-b52b7c37",
                "title": "Volkswagen Golf 1.4 TSI 125 Match Edition 5dr DSG",
                "make": {
                    "id": "volkswagen",
                    "label": "Volkswagen"
                },
                "model": {
                    "id": "volkswagen-golf",
                    "label": "Golf"
                },
                "variant": "1.4 TSI 125 Match Edition 5dr DSG",
                "price": 13499,
                "currency": "GBP",
                "is_vat_included": true,
                "year": 2016,
                "mileage": 15651,
                "registration": "SK66MDO",
                "stock_condition": "used",
                "previous_owners": 2,
                "body_type": "hatchback",
                "fuel_type": "petrol",
                "gearbox": "semiauto",
                "color": "blue",
                "doors": 5,
                "seats": 5,
                "engine_size": 1.4,
                "bhp": 123.4,
                "co2_g_km": 116,
                "first_registration_date": "2016-09-14",
                "is_ulez_compliant": false,
                "image_count": 35,
                "images": [
                    "https://cdn.uk.prod.group-mobility-trader.com/images/cas/811d30f1406ca1d31dbe202d3888873e/e8ef682826ac1c09a1bd3fd3c33e363c.jpg"
                ],
                "dealer": {
                    "id": "7237",
                    "name": "Car Deal Warehouse Superstore Newbridge",
                    "city": "Newbridge"
                },
                "location": {
                    "postcode": "EH288TH",
                    "latitude": 55.942214,
                    "longitude": -3.405555
                },
                "created_at": "2026-10-07T06:30:41Z",
                "last_updated_at": "2026-10-15T01:43:15Z",
                "active_at": "2026-10-07",
                "url": "https://drive.co.uk/auto/volkswagen-golf-2016-14-tsi-125-match-edition-5dr-dsg-b52b7c37"
            }
        ],
        "total": 149,
        "page": 0,
        "size": 20,
        "total_pages": 50,
        "has_more": true,
        "next_page": 1
    },
    "meta": {
        "endpoint_family": "dealer",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 404 | Resource Not Found | The requested heycar resource does not exist. This response is not billable. |
| 502 | Invalid Source Response | The upstream answered with a shape that no longer matches the documented contract. This response is not billable. |
| 503 | Service Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## 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)