> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truckaurbus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> The same data behind truckaurbus.com, for your app, fleet tool, dealer CRM or assistant.

Truckaurbus keeps a verified catalogue of new commercial vehicles sold in India: verified specifications, prices with their basis (maker, dealer, reported, estimate), what owners and drivers say per pillar, dealers by PIN code, and a consented route to send a buyer's enquiry to a dealer.

The API is versioned in the path (`/v1`) and lives at `https://api.truckaurbus.com`. Every response is JSON. You authenticate with a key from your account page; the key's tier sets your limits.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/quickstart">Your first call in two minutes.</Card>
  <Card title="API reference" icon="book" href="/api-reference">Every resource, generated from the live contract.</Card>
  <Card title="SDKs" icon="code" href="/guides/sdks">Python and TypeScript clients on PyPI and npm.</Card>
  <Card title="MCP" icon="robot" href="/guides/mcp">Give Claude, Cursor or any MCP client the catalogue as tools.</Card>
  <Card title="Login with Truckaurbus" icon="user-check" href="/guides/login-with-truckaurbus">Authenticate truckaurbus users in your app: OpenID Connect, verified phone identity.</Card>
</CardGroup>

## What you can read and write

* `GET /v1/variants` searches with filters (class, maker, body, fuel, axle, GVW, price, power) and returns facets.
* `GET /v1/variants/{slug}` is the full sheet: spec groups, prices with kind and date, media, siblings.
* `GET /v1/variants/{slug}/ratings` is what owners and drivers say, per pillar: scores and counts. The comments themselves stay on truckaurbus.com.
* `GET /v1/manufacturers`, `GET /v1/dealers?pin=`, `GET /v1/pincodes/{pin}`.
* `POST /v1/leads` records a buyer's request with explicit consent and routes it to the dealer.
* Business keys get `GET /v1/export/variants.csv`; enterprise keys register webhooks.

## Attribution

Free-tier apps show "Data by Truckaurbus" with a link wherever the data appears. The `X-Attribution` header on every free-tier response carries the exact text.