Tool reference

Directory of active ADN rooftops: slug, name, dealer group, OEM programs, location metadata, and per-rooftop manifest URL. Pass country=CA for Canadian dealers.

Access: No credential required

Availability: every rooftop.

Browse available inventory across the network, one page at a time. For counts or distributions call inventory_stats; to copy the catalog call network_snapshot (one download replaces hundreds of pages). Results are slim summary rows; embed hero_photo_url as a markdown image when presenting a vehicle, and call inventory_get with rooftop_slug for its full photo gallery. Optional OEM program scope; optional geographic radius — latitude and longitude together; radius_miles defaults to 50 (max 500) and needs both. Rooftops without coordinates are excluded from geo-scoped results. Pass country=CA for Canadian dealers. Listed prices may exclude doc/government fees and tax — call quote_preview for the estimated total. Totals are estimates at best; when pricing_coverage is "partial_estimate", present the total as a subtotal excluding the charges in excluded. Always relay pricing_disclosure.

Access: No credential required

Availability: every rooftop.

Aggregate available inventory across the network in ONE call: counts, effective-price min/median/max and the top values per facet. Example: {"dimensions": ["make_model", "body_style"], "condition": "used", "rooftop_slugs": ["mms"]}. Geo (latitude and longitude, optional radius_miles) and oem_program_slug scope exactly as network_search. Pivot mode (group_by, up to 2 of the facets plus state, dealer_group, price_band, age_band) returns one row per group with count and medians; dimensions and group_by are mutually exclusive; format csv returns the rows as CSV. Pass country=CA for Canadian dealers.

Access: No credential required

Availability: every rooftop.

Fetch one available unit by identity (VIN) from a named rooftop (rooftop_slug from network_search results). Returns the full detail shape — ordered photo gallery, options, plain-text description; embed the first few photo_urls as markdown images when presenting the vehicle. Unknown or ineligible identity/rooftop returns unit_not_found. Listed prices may exclude doc/government fees and tax — call quote_preview for the estimated total. Totals are estimates at best; when pricing_coverage is "partial_estimate", present the total as a subtotal excluding the charges in excluded. Always relay pricing_disclosure.

Access: No credential required

Availability: every rooftop.

Export the whole network catalog (or one rooftop with rooftop_slug) as one gzip artifact instead of paging: returns a descriptor with a generation URL, strong ETag, row and byte counts, expiry and (when available) sync_cursor; small results are inlined as rows_inline. Views: manifest (identity, pricing, key attributes; default), summary (the network_search row), full (the inventory_get row). Formats: csv (default), json. Example: {"view": "manifest", "format": "csv"}. Re-download only when the ETag changes; poll inventory_changes with sync_cursor to stay current. Pass country=CA for Canadian dealers.

Access: No credential required

Availability: every rooftop.

State synchronization for a mirror built from network_snapshot: pass the sync_cursor and receive upserts (current rows in the same view) and tombstones since that position, with has_more and next_cursor. Bounded eventual consistency: take a fresh snapshot at least every 24 hours and whenever resync_required is true. Example: {"cursor": "<sync_cursor from network_snapshot>"}. Pass country=CA for Canadian dealers.

Access: No credential required

Availability: every rooftop.

Price context for one vehicle against like units across the network (same make, model, exact model year, condition; optional trim and geo). Example: {"identity": "<VIN>", "rooftop_slug": "mms"} or {"make": "Subaru", "model": "Outback", "model_year": 2024, "condition": "used"}. Returns count, price quartiles, the subject's rank and up to 5 cheapest peers. Advertised prices only; call quote_preview for a total. Pass country=CA for Canadian dealers.

Access: No credential required

Availability: every rooftop.

One named rooftop's store record: name, dealer group, OEM programs, location/contact metadata, and fee schedule. Pass rooftop_slug. Whether a specific unit's listed price already includes a fee varies per unit — quote_preview returns the estimated total. Fee schedules may be incomplete — an unlisted fee is not a guarantee that no such fee applies; confirm final charges with the dealer.

Access: No credential required

Availability: every rooftop.

Read-only out-the-door price preview for one available unit at a named rooftop (pass rooftop_slug): base price plus itemized fees and taxes — fees already included in the listed price are flagged included_in_price and add nothing on top. Persists nothing; free to call while browsing. Fee schedules may be incomplete — an unlisted fee is not a guarantee that no such fee applies; confirm final charges with the dealer. Totals are estimates at best; when pricing_coverage is "partial_estimate", present the total as a subtotal excluding the charges in excluded. Always relay pricing_disclosure.

Access: No credential required

Availability: every rooftop.

Out-the-door quote for one available unit at a named rooftop. Anonymous calls are stateless; authenticated calls persist a deal thread. Anonymous calls persist nothing; quote_preview is the read-only equivalent for browsing. Fee schedules may be incomplete — an unlisted fee is not a guarantee that no such fee applies; confirm final charges with the dealer. Totals are estimates at best; when pricing_coverage is "partial_estimate", present the total as a subtotal excluding the charges in excluded. Always relay pricing_disclosure.

Access: Works anonymously; a key unlocks more

Availability: every rooftop.

Prepare a named dealership's exact contact disclosure and a short-lived signed binding.

Access: No credential required

Availability: every rooftop.

Submit the shopper's bound contact request to the named dealership.

Access: No credential required

Availability: every rooftop.

Search one rooftop's available inventory. Results are slim summary rows; embed hero_photo_url as a markdown image when presenting a vehicle, and call inventory_get for its full photo gallery, options, and plain-text description. Listed prices may exclude doc/government fees and tax — call quote_preview for the estimated total. Totals are estimates at best; when pricing_coverage is "partial_estimate", present the total as a subtotal excluding the charges in excluded. Always relay pricing_disclosure.

Access: No credential required

Availability: 33 out of 33 rooftops.

Aggregate filtered available inventory for one rooftop.

Access: No credential required

Availability: 33 out of 33 rooftops.

Fetch one available unit by identity (VIN) from this rooftop. Returns the full detail shape — ordered photo gallery, options, and plain-text description; embed the first few photo_urls as markdown images when presenting the vehicle. Unknown or removed identity returns an unit_not_found error envelope. Listed prices may exclude doc/government fees and tax — call quote_preview for the estimated total. Totals are estimates at best; when pricing_coverage is "partial_estimate", present the total as a subtotal excluding the charges in excluded. Always relay pricing_disclosure.

Access: No credential required

Availability: 33 out of 33 rooftops.

This rooftop's store record: name, dealer group, OEM programs, location/contact metadata, and fee schedule. Fee schedules may be incomplete — an unlisted fee is not a guarantee that no such fee applies; confirm final charges with the dealer.

Access: No credential required

Availability: 33 out of 33 rooftops.

Read-only out-the-door price preview for one available unit (VIN): base price plus itemized fees and taxes — fees already included in the listed price are flagged included_in_price and add nothing on top. Persists nothing; free to call while browsing. Use deal_quote to persist a durable quote. Fee schedules may be incomplete — an unlisted fee is not a guarantee that no such fee applies; confirm final charges with the dealer. Totals are estimates at best; when pricing_coverage is "partial_estimate", present the total as a subtotal excluding the charges in excluded. Always relay pricing_disclosure.

Access: No credential required

Availability: 32 out of 33 rooftops.

Quotes and lead submission are not offered for dealerships in Canada. Inventory search is available, and every vehicle links to the dealer's own website.

Out-the-door quote for one available unit (VIN). Anonymous calls return a stateless calculation with assumptions; authenticated calls (agent API key + idempotency_key) persist a deal thread and a durable quote. All money values are exact decimal strings. Anonymous calls persist nothing; quote_preview is the read-only equivalent for browsing. Fee schedules may be incomplete — an unlisted fee is not a guarantee that no such fee applies; confirm final charges with the dealer. Totals are estimates at best; when pricing_coverage is "partial_estimate", present the total as a subtotal excluding the charges in excluded. Always relay pricing_disclosure.

Access: Works anonymously; a key unlocks more

Availability: 32 out of 33 rooftops.

Quotes and lead submission are not offered for dealerships in Canada. Inventory search is available, and every vehicle links to the dealer's own website.

Prepare the dealership's exact contact disclosure and a short-lived signed binding. Present the disclosure before calling lead_submit.

Access: No credential required

Availability: 32 out of 33 rooftops.

Quotes and lead submission are not offered for dealerships in Canada. Inventory search is available, and every vehicle links to the dealer's own website.

Submit the shopper's bound contact request after presenting the server-authored disclosure.

Access: No credential required

Availability: 32 out of 33 rooftops.

Quotes and lead submission are not offered for dealerships in Canada. Inventory search is available, and every vehicle links to the dealer's own website.

Place a soft hold on the unit of a deal thread with an unexpired quote. One active hold per unit; short expiry; requires agent API key and idempotency_key.

Access: Requires an agent key

Availability: 32 out of 33 rooftops.

Quotes and lead submission are not offered for dealerships in Canada. Inventory search is available, and every vehicle links to the dealer's own website.

Release the active soft hold(s) on a deal thread. Requires agent API key and idempotency_key.

Access: Requires an agent key

Availability: 32 out of 33 rooftops.

Quotes and lead submission are not offered for dealerships in Canada. Inventory search is available, and every vehicle links to the dealer's own website.

Hand a consented consumer lead to the rooftop's sales desk. Requires the signed disclosure from deal_handoff_prepare, an agent API key, and idempotency_key. One handoff per thread.

Access: Requires an agent key

Availability: 32 out of 33 rooftops.

Quotes and lead submission are not offered for dealerships in Canada. Inventory search is available, and every vehicle links to the dealer's own website.

Prepare the dealership's exact handoff disclosure and a short-lived signed binding for an open deal thread.

Access: Requires an agent key

Availability: 32 out of 33 rooftops.

Quotes and lead submission are not offered for dealerships in Canada. Inventory search is available, and every vehicle links to the dealer's own website.

Fetch one of your deal threads: lifecycle, derived stage, latest quote, hold, and handoff delivery status.

Access: Requires an agent key

Availability: 33 out of 33 rooftops.