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, FCA compliance status, and business volume information.

Base Path

GET https://api.marketcheck.com/v2/dealer/car/uk/{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/uk/10030188',
  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

Use Cases & Examples

Retrieve Dealer Information

Get comprehensive details about a specific dealer including contact information, location, FCA compliance status, 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/uk/10030188',
  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 and FCA Status

Check if a dealer exists in MarketCheck's UK system and get their current status, FCA compliance information, and activity level based on their inventory count.

Example:

Here we're verifying dealer existence and getting their current FCA status:

import axios from 'axios';

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

Response

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

Success Response

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

Error Response

Response 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 vehicles currently listed by dealer
  dealer_type: string; // Type classification (franchise, independent)
  dealership_group_name?: string; // Parent dealership group name if applicable
  fca_status?: string; // FCA authorization status for UK dealers (Ex. Authorised)
  fca_reference_no?: string; // FCA reference number if available
  street: string; // Street address of the dealer
  city: string; // City where dealer is located
  country: string; // Country code (UK)
  county?: string; // County or region if available
  zip: string; // Postal code
  postal_code: string; // Postal 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
}

See Also

• Dealers Search
• Inventory Search