Dealer Details

Find RV dealer in USA using MarketCheck Dealer ID
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 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.

Base Path

GET https://api.marketcheck.com/v2/dealer/rv/{dealer_id}

Path Parameters:

  • dealer_id - Unique identifier for the dealer in MarketCheck's system

The following example demonstrates how to retrieve details for a specific dealer using their MarketCheck dealer ID:

request.js
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);
}

Request

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.

Parameters

Available parameters for retrieving detailed dealer information:

1 Params
api_key
string required

Your MarketCheck API authentication key. Required for every request, unless OAuth is used.

Required Parameters

The following parameters are required for dealer detail requests:

  • dealer_id - The unique identifier for the dealer (provided in URL path)
    • String identifier from MarketCheck's dealer directory
    • Must be provided as a path parameter in the URL structure
    • Case-sensitive string value

Response

The RV Dealer Details API returns comprehensive information about the specified dealer in a structured JSON format.

Schema

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
}

Success Response

  • 200 OK - Returns a JSON object containing detailed dealer information including contact details, location, inventory URL, volume, and business classification

Error Response

Status CodeDescriptionCommon Causes
400Bad RequestInvalid parameter values
401UnauthorizedMissing/invalid API key
403ForbiddenAccess denied to resource
422Unprocessable EntityInvalid dealer_id
429Too Many RequestsRate limit exceeded
500Internal Server ErrorTemporary server issues
502Bad GatewayIssues with upstream services
503Service UnavailableAPI maintenance or downtime

Use Cases & Examples

Retrieve Dealer Information

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:

request.js
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);
}

Verify Dealer Existence

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:

request.js
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);
}

See Also