> ## 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.

# Used market

> Live used listings and the yard's lots, read only, on business and enterprise keys.

The used market comes through the key on the scope `market:read`, which business and enterprise keys carry. It is read only: there is no bidding and no enquiry through the API. A buyer reaches a seller on truckaurbus.com, where the seller's number is shown to a signed-in, verified buyer. No contact key leaves through a key.

## Listings

`GET /v1/market/listings` returns live used listings, newest first, with the used market's own filters: `maker`, `vehicle_class`, `state`, `q`, `axle`, `fuel`, `year_min`, `year_max`, `km_max`, `price_min`, `price_max`, `seller` (`owner` or `dealer`), `dealer` (a dealer's slug), and for machines `kind=machine`, `machine_class`, `machine_slug`, `hours_max`. Page with `limit` and `offset`.

A listing carries the variant and the maker, the year, the kilometres (or the hours for a machine), the owners, `price_inr` with `comparable_new_inr` beside it (the register's new price for the same variant), the state and district, the photographs and the seller's kind. `GET /v1/market/listings/{id}` adds the description, the condition sheet, the inspection mode and the listing's updates.

```bash theme={"system"}
curl "https://api.truckaurbus.com/v1/market/listings?vehicle_class=tipper&state=MH&year_min=2020&price_max=2500000" \
  -H "Authorization: Bearer tab_live_..."
```

An asking price is a seller's figure: label it as asking, and show `comparable_new_inr` with its own label when you show both.

## The yard

`GET /v1/market/lots` is the yard: lots with their current auction. `status` is `live` by default (also `upcoming`, `closed`); `sort` is `ending` by default. Filter with `mode`, `vehicle_class`, `maker`, `state`, `institution` (the seller's slug), `seller_kind`, `year_min`, `budget_max_inr`, `axle`, `fuel`, `q`. `GET /v1/market/lots/{id}` is one lot: the auction and its rounds, the gallery, the questions and amendments, the quarter's context.

A reserve shows only where the institution made it public. Bidding, registration and inspection bookings happen on the site.