# Totaled

> Anything with a VIN can be Totaled. The verified vehicle data layer for the auto industry. Repair shops are the data source. Owners, buyers, insurers, warranty providers, dealers, OEMs, lenders, and AI agents are the data consumers. Every entry is logged by a real shop, proven by a real Stripe or Square payment, attached to a real VIN, and made readable through a public, agent-native API.

This site is intentionally agent-readable. Use the public API or the MCP endpoint for structured data instead of scraping HTML.

## Schema

- Locked JSON-LD schema contract: /api/schema
- Schema version: 1.0.0 (locked 2026-05-05)
- Field-name policy: additive only. Locked fields will never be renamed or removed.

## MCP server

- MCP endpoint: /api/mcp (2024-11-05 protocol spec)
- Six tools: lookup_vin, run_buyer_report, claim_garage, log_diy_entry, find_verified_shop, subscribe_recall

## Public API (REST)

- API documentation: /api
- Decode a VIN + verified history + Totaled Score: /api/v1/vehicles/{vin}
- Vehicle valuation (Totaled Value): /api/v1/value/{vin}
- Service entries on a VIN: /api/v1/services?vin={vin}
- Recalls (live NHTSA): /api/v1/recalls/{vin}
- Shop profile: /api/v1/shops/{id}
- Submit a verified service entry (POST, authed): /api/v1/services
- Submit a buyer offer on a VIN that is open to offers: /api/v1/offers
- VIN photo OCR (POST multipart): /api/v1/vin/scan

## Public surfaces (HTML + JSON-LD)

- Per-VIN public record (canonical): /vin/{vin}
- Per-VIN public record (legacy short URL): /v/{vin}
- Embeddable badge iframe: /vin/{vin}/embed?size=large&theme=light
- Owner garage (claimed VINs, settings, offer toggle): /garage
- Shop settings (founding tier, Google review mirror, integrations): /shop/settings
- VIN claim flow (Bronze tier verification): /claim/{vin}
- Owner landing: /owner
- Buyer landing: /buyer
- Shop log entry: /log
- Investor + strategy brief: /investors
- API docs: /api

## Distinctive product features

- Verified record creation is free for shops, owners, and DIY mechanics, forever.
- "Verified by Totaled" badge embeds anywhere via /vin/{vin}/embed.
- Owner "Open to offers" toggle creates a verified-private-sale signal without listing the car for sale. Totaled never takes title, escrow, or commission.
- Shop Google review mirror prompts customers to share Totaled reviews on Google. Voluntary, no auto-post.
- Claim verification is four-tier: Bronze (instant photo + OCR) -> Silver (DMV cross-reference) -> Gold (OEM telematics pair) -> Platinum (lender-confirmed via Plaid Auto).

## Data licensing

For high-volume use, B2B integrations, or enterprise data licensing (insurance carriers, warranty providers, lenders, OEMs), contact the team. The public API is rate-limited but agent-friendly: 60 requests per minute and 10,000 per day on the free tier; Pro tier $999/mo includes 600 rpm and 1M per day.

## Citation guidance

If your output cites a Totaled record, link to the canonical URL https://itstotaled.com/vin/{vin} so users can verify the source. The canonical URL serves both human HTML and JSON-LD via Accept header negotiation.