List external identifiers for a dealership

GET

/api/v1/dealerships/{dealership_id}/external_identifiers

const url = 'https://dashboard.dealerstudio.com.au/api/v1/dealerships/1/external_identifiers?identifier_name=stellantis';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://dashboard.dealerstudio.com.au/api/v1/dealerships/1/external_identifiers?identifier_name=stellantis' \
  --header 'Authorization: Bearer <token>'

Returns external identifiers for a dealership. When car_id is provided, resolves identifiers using fallback logic (location-specific > dealership-level, car_type match > nil car_type). Requires API key authentication with the index:external_identifier permission.

Authorizations

Bearer

Parameters

Path Parameters

dealership_id

required

integer

Dealership ID

Query Parameters

car_id

integer

Optional. When provided, resolves identifiers for the specific car using fallback logic.

identifier_name

Filter by external identifier name

string

Allowed values: stellantis angle podium_location oem_dealer_code dealersocket_rooftop_id dealersocket_code ford_dealer_code ford_dealer_correlation_id allied_lender_code allied_introducer_code allianz_intermediary_id byd_dealer_code toyota_lead_location_name_mapping acv_partner_id

Optional. Filter by identifier name.

Responses

200

Resolved for a specific car

application/json

Array<object>

object

required

integer

identifier_name

required

string

primary_code

required

string

secondary_code

string

nullable

car_type

string

nullable

Allowed values: new demo used

dealership_id

required

integer

location_id

integer

nullable

location_name

string

nullable

manufacturer_id

integer

nullable

manufacturer_name

string

nullable

Example

[
  {
    "identifier_name": "stellantis",
    "car_type": "new"
  }
]

401

Unauthorized - invalid API key

403

Forbidden - API key restricted to different dealership

404

Car not found