Skip to content
Vyro Developers

Vehicle URLs

Every vehicle has a page on its dealer’s Vyro website. Link to it from your listing so shoppers can enquire, book a test drive or order.

https://{showroom.domain}/vehicles/stocked/{vehicle.code}?region_id={pricing code}
query VehicleLink($showroomId: uuid!, $vehicleId: uuid!) {
  showrooms_by_pk(id: $showroomId) {
    domain
    https_enabled
  }
  stocked_vehicles_by_pk(id: $vehicleId) {
    code
  }
}
function vehicleUrl(showroom, vehicle, pricingCode) {
  const scheme = showroom.https_enabled === false ? 'http' : 'https';
  const domain = showroom.domain.replace(/^https?:\/\//, '').replace(/\/+$/, '');
  const url = new URL(`${scheme}://${domain}/vehicles/stocked/${encodeURIComponent(vehicle.code)}`);
  if (pricingCode) url.searchParams.set('region_id', pricingCode);
  return url.toString();
}


vehicleUrl(
  { domain: 'www.exampledealer.com.au', https_enabled: true },
  { code: '2024-bmw-ix1-edrive20-xline-32c476f6-e87a-419b-84bb-72e902dca5af' },
  'AU_VIC',
);
// https://www.exampledealer.com.au/vehicles/stocked/2024-bmw-ix1-edrive20-xline-32c476f6-e87a-419b-84bb-72e902dca5af?region_id=AU_VIC
  • code is the vehicle’s permanent URL key. It is usually a readable slug, but treat it as an opaque string: don’t build it yourself or parse it.
  • region_id sets the state on the dealer’s site, so the shopper sees the price you showed them.
  • Add your own UTM parameters (utm_source, utm_medium, utm_campaign) so the dealer can see leads from you. Vyro records them on the enquiry.
  • A sold vehicle’s page keeps working, and says it’s sold.
Section titled “External links”

Some vehicles have external_cta_url, a link to the listing on the dealer’s own (non-Vyro) website. When it is set, the dealer prefers you link there.