# RV Listing Details

> Retrieve detailed information about specific UK dealer RV listings with complete vehicle specifications, media content, dealer information, and marketplace data.

> **WARNING**: 
> **Limited Support Warning**: RV APIs is maintained less frequently than our primary cars dataset, with reduced priority and support. Data quality, coverage, and feature updates may be less comprehensive and occur less often than in our core automotive offerings.

The Listing Details API retrieves detailed information about specific dealer recreational vehicle listings across the United Kingdom market. This endpoint provides complete listing data including vehicle specifications, pricing history, dealer information, media content, and marketplace details for individual listings identified by their unique listing ID.

This API is typically used as a follow-up to search operations from the [Inventory Search API](/uk/docs/api/recreational-vehicles/inventory/inventory-search), which returns listing IDs for detailed retrieval.



## Base Path

```http
GET https://api.marketcheck.com/v2/listing/rv/uk/{listing_id}
```

**Path Parameter:**

- `listing_id` - The unique identifier for the RV listing you want to retrieve. This parameter is case-sensitive and must be provided in the URL path.

The following example demonstrates how to use the RV Listing Details API to retrieve information about a specific RV listing:

```bash
curl --request GET \
  --url https://api.marketcheck.com/v2/listing/rv/uk/4851c44c3371be28fa3d73e5789290d87231edbc8f011ab485bc17f28984947d58c2a54aabb2156e15e48485027d9631
```

Explore the complete parameter options and response structure in the [Request](#request) section below.



## Request

The RV Listing Details API provides access to detailed listing information using the unique listing identifier. This is typically used as a follow-up to search operations from the [Inventory Search API](/uk/docs/api/recreational-vehicles/inventory/inventory-search), which returns listing IDs for detailed retrieval.



### Parameters

Available parameters for retrieving detailed listing information:

| Parameter   | Type        | Required    | Description |
|-------------|-------------|-------------|-------------|
| `api_key` | string | Yes | Your MarketCheck API authentication key. Required for every request, unless OAuth is used. |




### Required Parameters

The following parameters are required for listing detail requests:

- **listing_id** - The unique identifier for the RV listing (provided in URL path)

  - Case-sensitive string identifier returned from search APIs or data feeds
  - Must be provided as a path parameter in the URL structure



## Use Cases & Examples



### Detailed Vehicle Information Display

Retrieve detailed vehicle information for display on RV detail pages, customer applications, or internal dealer management systems. This API provides all the data typically shown on a dealer's RV detail page (VDP).

**Example:**

Here we're retrieving complete details for a specific RV listing including specifications, pricing, dealer information, and media content:

```bash
curl --request GET \
  --url https://api.marketcheck.com/v2/listing/rv/uk/4851c44c3371be28fa3d73e5789290d87231edbc8f011ab485bc17f28984947d58c2a54aabb2156e15e48485027d9631
```



### Post-Search Detail Retrieval

After performing searches using the Inventory Search API, use the returned listing IDs to fetch complete RV details for selected listings.

**Example:**

Here we're retrieving detailed information for a RV listing discovered through inventory search:

```bash
curl --request GET \
  --url https://api.marketcheck.com/v2/listing/rv/uk/5e26509baf03b28274d8041da8f6f0d8466698ce92fb50c3e54ec06848a6a4c55155ae97da94540a593b97f3c43ef332
```

> **IMPORTANT**: 
> This data is fetched directly from MarketCheck's main database, which is updated continuously as crawl progresses. Some fields like `last_seen_at`, `scraped_at`, and `first_seen_at` may not match the values in search API responses due to real-time data processing.



## Response

The UK RV Listing Details API returns comprehensive information about the specified recreational vehicle listing in a structured JSON format.

**Success Response:**

- **200 OK** - Returns detailed JSON object with complete listing information
- Includes RV specifications, pricing data, dealer information, media content, and marketplace metadata
- Provides rich data suitable for RV detail page display and detailed analysis



### Response Schema

The response provides comprehensive listing details organised into logical sections:

```ts
interface RVSearchResponse {
  listings: RVListing[]; // Array of vehicle listings
}

interface RVListing {
  id: string; // Unique listing identifier
  heading: string; // Formatted listing title
  price: number; // Current listing price
  miles: number; // Vehicle mileage
  vdp_url: string; // Vehicle detail page URL
  seller_type: string; // Type of seller (dealer, fsbo, auction)
  inventory_type: string; // Inventory classification (new, used)
  last_seen_at: number; // Last seen timestamp (Unix Seconds), when the listing was last updated
  last_seen_at_date: string; // Last seen date (ISO format)
  scraped_at: number; // First seen timestamp (Unix Seconds), when the listing was first scraped
  scraped_at_date: string; // First seen date (ISO format)
  first_seen_at: number; // First seen timestamp (Unix Seconds), when the listing was first seen. Copy of `scraped_at` field
  first_seen_at_date: string; // First seen date (ISO format)
  source: string; // Data source website domain
  miles_indicator: string; // Mileage unit indicator
  currency_indicator: string; // Currency unit indicator
  motorhome_build: string; // Motorhome build specifications
  origin: string; // Vehicle origin information
  media: RVMedia; // Photos and media content links
  extras: RVExtras; // Additional features and options
  dealer: RVDealer; // Dealer information
  build: RVBuild; // Vehicle specifications
}

interface RVMedia {
  photo_links: string[]; // Array of photo URLs from dealer website
  floorplan_image_link?: string; // Floorplan image URL
}

interface RVExtras {
  options: string[]; // Array of additional features and options
}

interface RVDealer {
  id: number; // Unique dealer identifier
  website: string; // Dealer website URL
  name: string; // Dealer business name
  street: string; // Street address
  city: string; // City name
  county: string; // County name
  country: string; // Country code
  latitude: string; // Geographic latitude
  longitude: string; // Geographic longitude
  zip: string; // Postal/ZIP code
  phone: string; // Contact phone number
}

interface RVBuild {
  year: number; // Model year
  make: string; // Vehicle manufacturer
  model: string; // Vehicle model
  transmission: string; // Transmission type
  fuel_type: string; // Fuel type (gasoline, electric, hybrid, etc.)
  engine: string; // Engine description
  drive_type: string; // Drive type configuration
  chassis: string; // Chassis specifications
  berths: string; // Sleeping capacity
  exterior_length?: string; // Vehicle length
  mtplm?: string; // Maximum Technically Permissible Laden Mass
  steering: string; // Steering configuration
  category: string; // Vehicle category
}
```

**Error Response:**

| Status Code   | Description   | Common Causes |
|---------------|---------------|---------------|
| 400 | Bad Request | Invalid parameter values |
| 401 | Unauthorized | Missing/invalid API key |
| 403 | Forbidden | Access denied to resource |
| 422 | Unprocessable Entity | Invalid `listing_id` |
| 429 | Too Many Requests | Rate limit exceeded |
| 500 | Internal Server Error | Temporary server issues |
| 502 | Bad Gateway | Issues with upstream services |
| 503 | Service Unavailable | API maintenance or downtime |




## See Also

- [RV Inventory Search](/uk/docs/api/recreational-vehicles/inventory/inventory-search)
- [RV APIs Overview](/uk/docs/api/recreational-vehicles/)