Vehicle Tag Taxonomy

Organize inventory with
custom tag groups

Create named tags like "Hit List" or "Weekend Specials", assign stock numbers, and serve curated vehicle lists to your specials pages — all from one API.

Features

Everything you need for vehicle tag management

🏷️
Named tags
Create slug-based tags like "hit-list" or "weekend-specials". Each tag gets a unique API endpoint for fetching assigned vehicles.
🚗
Stock assignments
Assign stock numbers to tags individually or in bulk. Paste a list, click add — the API handles deduplication automatically.
Live inventory
Vehicle data is hydrated at query time from the inventory pipeline. No sync jobs, no stale card data — always current.
🔐
JWT + SSO auth
Dashboard is SSO-gated. External API consumers use JWT tokens with dealer or admin scope. Role-based access enforced on every request.
How it works

From tag creation to specials page in minutes

Step 1
Create a tag
Name it, slug it, describe it. Tags are scoped to a dealer and addressable by slug in every API call.
Step 2
Assign vehicles
Add stock numbers individually or paste a batch. The API deduplicates and tracks who made each assignment.
Step 3
Fetch via API
GET the tag's vehicle list — hydrated with live inventory data. Drop the endpoint into GTM or the specials widget.
Step 4
Clean up stale
Vehicles that leave inventory are flagged as stale. Review and purge from the dashboard on your schedule.
API

REST API for tags and vehicle assignments

All routes require Authorization: Bearer {token}. Dealer tokens are scoped; admin tokens access all dealers.

fetch tagged vehicles
GET /api/v1/dealers/honda-perrysburg/tags/hit-list/vehicles

// Response:
{
  "tag": { "slug": "hit-list", "label": "Hit List" },
  "vehicles": [
    { "stockNumber": "H12345", "year": 2021, "make": "Honda", ... }
  ],
  "count": 1
}