The RV Dealer Details API retrieves detailed information about a specific recreational vehicle dealer using their unique MarketCheck dealer ID. This endpoint provides comprehensive dealer data including public contact information, location details, inventory URL, and business volume information.
GET https://api.marketcheck.com/v2/dealer/rv/{dealer_id}
Path Parameters:
dealer_id
- Unique identifier for the dealer in MarketCheck's systemThe following example demonstrates how to retrieve details for a specific dealer using their MarketCheck dealer ID:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/dealer/rv/6490',
params: {api_key: 'YOUR_API_KEY'},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
The Dealer Details API provides access to detailed dealer information using the unique dealer identifier. This endpoint is typically used when you have a dealer ID from search operations or want to retrieve comprehensive information about a specific dealer.
Available parameters for retrieving detailed dealer information:
Your MarketCheck API authentication key. Required for every request, unless OAuth is used.
The following parameters are required for dealer detail requests:
The RV Dealer Details API returns comprehensive information about the specified dealer in a structured JSON format.
interface Response {
id: string; // Unique dealer identifier in MarketCheck system
seller_name: string; // Display name of the dealer
inventory_url: string; // URL to dealer's inventory page
data_source: string; // Source system identifier
status: string; // Current status of the dealer (active, inactive)
listing_count: number; // Number of RVs currently listed by dealer
dealer_type: string; // Type classification (franchise, independent)
street: string; // Street address of the dealer
city: string; // City where dealer is located
state: string; // State or province abbreviation
country: string; // Country code (US)
zip: string; // ZIP code
latitude: string; // Geographic latitude coordinate
longitude: string; // Geographic longitude coordinate
seller_phone: string; // Primary phone number
seller_email?: string; // Email address if available
created_at: string; // Timestamp when dealer record was created
}
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 dealer_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 |
Get comprehensive details about a specific dealer including contact information, location, and business details for customer service, dealer verification, or integration purposes.
Example:
Here we're retrieving complete details for an dealer using their MarketCheck ID:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/dealer/rv/6490',
params: {api_key: 'YOUR_API_KEY'},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
Check if a dealer exists in MarketCheck's system and get their current status and activity level based on their inventory count.
Example:
Here we're verifying dealer existence and getting their current status:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/dealer/rv/10000004',
params: {api_key: 'YOUR_API_KEY'},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
RV Listing Details
Retrieve detailed information about specific dealer RV listings with complete vehicle specifications, media content, dealer information, and marketplace data.
Dealers Search
Search through MarketCheck's RV dealer directory from the US using various criteria like location, dealer type, and inventory characteristics