Skip to content
AutomotiveMCP
SchemasInventory · R01RFC / v0.1

Inventory Snapshot

v0.1.0

A point-in-time snapshot of a dealer's vehicle inventory feed, returned by inventory.get_snapshot. Captures the feed run metadata, roll-up counts and monetary totals, aging and turn analysis, syndication/merchandising health, and a per-vehicle line summary. Modernizes the traditional flat inventory export (CSV/ADF vehicle listings, IMT/vAuto/HomeNet/DealerSpecialties feeds) into a typed, correlatable JSON envelope so AI agents can reason over stocking, pricing, aging, and merchandising without pulling each Vehicle record individually. Individual vehicles are referenced by id (vehicle_id) rather than embedded in full; fetch the full Vehicle entity from inventory resources when detail is needed.

Resourcesinventory.get_snapshot

inventory-snapshot.example.jsonJSON
{
  "id": "b1f7c2e0-9a3d-4c1e-8f2a-6d5b4c3a2e10",
  "source_ids": [
    {
      "system": "cdk-dms",
      "id": "INV-2026-06-30-001",
      "sequence": 1
    },
    {
      "system": "homenet",
      "id": "HN-8842197",
      "sequence": 2
    }
  ],
  "dealer_id": "3c9a1b74-2e88-4d6f-b0a1-7c5e9f2d4a63",
  "dealer_name": "Cobalt Chevrolet of Austin",
  "rooftop_id": "7e2d4a63-1b74-4d6f-b0a1-3c9a2e885f21",
  "generated_at": "2026-06-30T06:15:00Z",
  "feed": {
    "run_id": "run_2026-06-30T06:15:00Z_full",
    "profile": "full-oem-report",
    "format": "json",
    "full_or_delta": "full",
    "schema_version": "0.2.0",
    "source_system": "CDK Global",
    "source_system_version": "9.4",
    "record_count": 142,
    "sequence_number": 4471
  },
  "currency": "USD",
  "counts": {
    "total": 142,
    "new": 88,
    "used": 54,
    "certified": 19,
    "demo": 3,
    "in_transit": 9,
    "wholesale": 2,
    "by_make": [
      {
        "make": "Chevrolet",
        "count": 96
      },
      {
        "make": "GMC",
        "count": 22
      },
      {
        "make": "Buick",
        "count": 14
      },
      {
        "make": "Toyota",
        "count": 6
      },
      {
        "make": "Ford",
        "count": 4
      }
    ],
    "by_body_style": [
      {
        "body_style": "suv",
        "count": 61
      },
      {
        "body_style": "truck",
        "count": 44
      },
      {
        "body_style": "sedan",
        "count": 27
      },
      {
        "body_style": "crossover",
        "count": 10
      }
    ],
    "by_price_band": [
      {
        "min": {
          "amount": 0,
          "currency": "USD"
        },
        "max": {
          "amount": 25000,
          "currency": "USD"
        },
        "count": 21
      },
      {
        "min": {
          "amount": 25000,
          "currency": "USD"
        },
        "max": {
          "amount": 50000,
          "currency": "USD"
        },
        "count": 78
      },
      {
        "min": {
          "amount": 50000,
          "currency": "USD"
        },
        "count": 43
      }
    ],
    "aging_buckets": {
      "days_0_30": 71,
      "days_31_60": 38,
      "days_61_90": 22,
      "days_over_90": 11
    }
  },
  "totals": {
    "inventory_value": {
      "amount": 6284500,
      "currency": "USD"
    },
    "cost_value": {
      "amount": 5731200,
      "currency": "USD"
    },
    "average_price": {
      "amount": 44257.75,
      "currency": "USD"
    },
    "median_price": {
      "amount": 41880,
      "currency": "USD"
    },
    "average_days_in_stock": 34.8,
    "median_days_in_stock": 28,
    "average_odometer": 41260.5,
    "days_supply": 58.3,
    "turn_rate": 9.1
  },
  "merchandising": {
    "with_photos": 131,
    "with_stock_photos_only": 14,
    "average_photo_count": 27.4,
    "with_description": 118,
    "with_price": 137,
    "photo_coverage_pct": 92.3,
    "price_coverage_pct": 96.5,
    "syndication_status": "healthy"
  },
  "vehicles": [
    {
      "vehicle_id": "9d4e2f10-3b6a-4c8d-9e1f-2a7b8c5d6e40",
      "vin": "1GNSKBKC5MR201457",
      "stock_number": "C26T1042",
      "condition": "new",
      "year": 2026,
      "make": "Chevrolet",
      "model": "Blazer",
      "trim": "RS",
      "body_style": "suv",
      "exterior_color": "Radiant Red Tintcoat",
      "interior_color": "Jet Black",
      "fuel_type": "gasoline",
      "drivetrain": "awd",
      "transmission": "automatic",
      "price": {
        "amount": 48995,
        "currency": "USD"
      },
      "msrp": {
        "amount": 49995,
        "currency": "USD"
      },
      "invoice": {
        "amount": 47010,
        "currency": "USD"
      },
      "cost": {
        "amount": 47010,
        "currency": "USD"
      },
      "days_in_stock": 12,
      "date_in_stock": "2026-06-18",
      "status": "available",
      "age_bucket": "days_0_30",
      "photo_count": 32,
      "has_stock_photos_only": false,
      "listing_url": "https://www.cobaltchevyaustin.com/new/Chevrolet/2026-Blazer-C26T1042.htm"
    },
    {
      "vehicle_id": "5a1c8b30-7d2e-4f9a-b6c1-3e8d4a2f5b90",
      "vin": "3GNKBERS2LS587321",
      "stock_number": "U26P0887",
      "condition": "certified",
      "year": 2022,
      "make": "Chevrolet",
      "model": "Equinox",
      "trim": "Premier",
      "body_style": "suv",
      "exterior_color": "Cobalt Blue Metallic",
      "interior_color": "Medium Ash Gray",
      "fuel_type": "gasoline",
      "drivetrain": "fwd",
      "transmission": "automatic",
      "odometer": 38214,
      "odometer_unit": "miles",
      "price": {
        "amount": 27450,
        "currency": "USD"
      },
      "cost": {
        "amount": 23100,
        "currency": "USD"
      },
      "days_in_stock": 63,
      "date_in_stock": "2026-04-28",
      "status": "available",
      "age_bucket": "days_61_90",
      "photo_count": 41,
      "has_stock_photos_only": false,
      "listing_url": "https://www.cobaltchevyaustin.com/used/Chevrolet/2022-Equinox-U26P0887.htm",
      "certified_program": "GM Certified"
    },
    {
      "vehicle_id": "e2b9d670-4c1a-48f3-9d2b-7a6e5c8f1d20",
      "stock_number": "N26T2210",
      "condition": "new",
      "year": 2026,
      "make": "GMC",
      "model": "Sierra 1500",
      "trim": "AT4",
      "body_style": "truck",
      "fuel_type": "gasoline",
      "drivetrain": "4wd",
      "transmission": "automatic",
      "price": {
        "amount": 72310,
        "currency": "USD"
      },
      "msrp": {
        "amount": 72310,
        "currency": "USD"
      },
      "days_in_stock": 4,
      "date_in_stock": "2026-06-26",
      "status": "in_transit",
      "age_bucket": "days_0_30",
      "photo_count": 1,
      "has_stock_photos_only": true
    },
    {
      "vehicle_id": "a7f3c220-9e5b-4d1c-8a2f-6b4d3e9c7a50",
      "vin": "1G1ZD5ST8LF051993",
      "stock_number": "U25P0431",
      "condition": "used",
      "year": 2020,
      "make": "Chevrolet",
      "model": "Malibu",
      "trim": "LT",
      "body_style": "sedan",
      "exterior_color": "Summit White",
      "interior_color": "Jet Black",
      "fuel_type": "gasoline",
      "drivetrain": "fwd",
      "transmission": "cvt",
      "odometer": 61890,
      "odometer_unit": "miles",
      "price": {
        "amount": 18990,
        "currency": "USD"
      },
      "cost": {
        "amount": 15400,
        "currency": "USD"
      },
      "days_in_stock": 118,
      "date_in_stock": "2026-03-04",
      "status": "on_hold",
      "age_bucket": "days_over_90",
      "photo_count": 22,
      "has_stock_photos_only": false,
      "listing_url": "https://www.cobaltchevyaustin.com/used/Chevrolet/2020-Malibu-U25P0431.htm"
    }
  ],
  "created_at": "2026-06-30T06:15:04Z",
  "updated_at": "2026-06-30T06:22:41Z",
  "created_by": "f4a2c1d8-6b3e-4a9f-8c2d-1e5b7a9d3c60",
  "extensions": {
    "com.homenet.syndication_health": "green",
    "com.cobalt.lot_zone_coverage_pct": 92.5
  }
}
Object shapes align with the AutomotiveAPI open data standard where sensible, and with the industry's ADF lead format — so a conformant server maps cleanly onto systems dealers already run.