Dealer Details

The Dealer Details API retrieves detailed information about a specific car 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/car/{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:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/dealer/car/10010052',
  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:

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 Dealer Details API returns comprehensive information about the specified dealer in a structured JSON format.

Schema

interface Response {
  dealer: Dealer; // Dealer object containing all detail information
}

interface Dealer {
  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 vehicles 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
  country: string; // Country code (US, CA)
  county?: string; // County or region if available
  zip: string; // Postal/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
  dealership_group_name?: string; // Parent dealership group name if applicable
}

Success Response

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

Error Response

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 a dealer using their MarketCheck ID:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/dealer/car/10010052',
  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:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/dealer/car/1000255',
  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

• Dealers Search
• Dealerships Search