# Edmunds Listing Detail API Documentation

Get the full detail of one Edmunds car listing by VIN: price, MSRP, price rating, vehicle specs (engine, drivetrain, transmission, mpg, features), colors, dealer name, address and phone, history flags, photos and the public Edmunds page url. A VIN that is not listed (for example because the car was sold) returns a not-billable 404.

- **Documentation:** [https://scrappa.co/docs/edmunds-api/edmunds_inventory_listing](https://scrappa.co/docs/edmunds-api/edmunds_inventory_listing)
- **API group:** Edmunds API
- **Endpoint:** `GET https://scrappa.co/api/edmunds/inventory/listing`

## 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 |
| --- | --- | --- | --- |
| `vin` | string | Yes | 17-character VIN without the letters I, O and Q. Take a current VIN from the inventory search. Example: 4T1DAACK6TU242320. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/edmunds/inventory/listing?vin=4T1DAACK6TU242320"
```

## Example response

```json
{
    "success": true,
    "data": {
        "listing": {
            "vin": "4T1DAACK6TU242320",
            "type": "used",
            "url": "https://www.edmunds.com/toyota/camry/2026/vin/4T1DAACK6TU242320/",
            "dealer_url": "https://www.businesscarsllc.com/inventory/toyota/camry/242320/",
            "published_at": "2026-10-15T05:38:01Z",
            "first_published_at": "2025-12-08T14:21:26Z",
            "days_listed": 331,
            "stock_number": "242320",
            "price": 33238,
            "msrp": 33238,
            "base_msrp": 31300,
            "destination_fee": 1195,
            "vehicle": {
                "year": 2026,
                "make": "Toyota",
                "model": "Camry",
                "trim": "SE",
                "style": "SE 4dr Sedan (2.5L 4cyl gas/electric hybrid CVT)",
                "style_id": "402082427",
                "body_type": "Sedan",
                "exterior_color": "Underground",
                "interior_color": "Black leatherette/cloth",
                "drivetrain": "front wheel drive",
                "engine_type": "hybrid",
                "cylinders": 4,
                "engine_size_liters": 2.5,
                "horsepower": 225,
                "fuel_type": "regular unleaded",
                "transmission": "CVT",
                "doors": 4,
                "seats": 5,
                "mpg_city": 47,
                "mpg_highway": 45,
                "mpg_combined": 46,
                "features": [
                    "Bluetooth",
                    "Stability Control",
                    "Adaptive Cruise Control",
                    "Tire Pressure Warning",
                    "Remote Start",
                    "Upgraded Headlights",
                    "Pre-collision safety system",
                    "Multi-Zone Climate Control",
                    "Trip Computer",
                    "USB Inputs",
                    "Fold Flat Rear Seats",
                    "Back-up camera",
                    "Blind Spot Monitoring",
                    "Post-collision safety system",
                    "Audio and cruise controls on steering wheel",
                    "Mobile Internet",
                    "Lane Departure Warning",
                    "Power Driver Seat",
                    "Rear Bench Seats",
                    "Alarm",
                    "Auto Climate Control"
                ]
            },
            "dealer": {
                "name": "Business Cars",
                "street": "219 W Manchester Blvd Ste 3",
                "city": "Inglewood",
                "state": "CA",
                "zip": "90301",
                "phone": "310-993-4004",
                "latitude": 33.961986,
                "longitude": -118.358306
            },
            "history": {
                "one_owner": true,
                "no_accidents": true,
                "clean_title": true,
                "usage_type": "Lease"
            },
            "photos": [
                "https://media.ed.edmunds-media.com/m2/for-sale/8e-4T1DAACK6TU242320/img-1-600x400.jpg",
                "https://media.ed.edmunds-media.com/m2/for-sale/8e-4T1DAACK6TU242320/img-2-600x400.jpg",
                "https://media.ed.edmunds-media.com/m2/for-sale/8e-4T1DAACK6TU242320/img-3-600x400.jpg",
                "https://media.ed.edmunds-media.com/m2/for-sale/8e-4T1DAACK6TU242320/img-4-600x400.jpg",
                "https://media.ed.edmunds-media.com/m2/for-sale/8e-4T1DAACK6TU242320/img-5-600x400.jpg",
                "https://media.ed.edmunds-media.com/m2/for-sale/8e-4T1DAACK6TU242320/img-6-600x400.jpg"
            ]
        }
    },
    "meta": {
        "endpoint_family": "listing_detail",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required query parameter is missing or invalid. This response is not billable. |
| 404 | Resource Not Found | The requested Edmunds resource does not exist. This response is not billable. |
| 503 | 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)