sany-sy215c, caterpillar-320) and carries a maker, a machine_class (see GET /v1/machines/classes for the classes, their labels in English, Hindi and Tamil, and each class’s plate fields), a kind within the class, operating_weight_kg, power_kw, a plate of the class’s headline figures, the full spec in groups, prices with their basis and date, and media.
Search
GET /v1/machines?q=&machine_class=&manufacturer=&weight_min=&weight_max=&power_min=&power_max=&price_max=&sort=&limit=&offset= returns total, hits and facets. q is typo-tolerant. Listing rows summarise the best figure as price_from_inr, price_to_inr, price_kind and price_as_of; a machine without a published figure has price_from_inr null, and the site shows “Price on request” for it.
One machine
GET /v1/machines/{slug} is the sheet. Prices carry source_kind (maker for an ex-works figure, dealer, reported, estimate) and observed_at; the rules from the Prices guide apply, and a machine’s maker figure is ex-works, never ex-showroom. launched_at is the maker’s launch day when known. lifecycle tells on_sale from discontinued.
The cost an hour
GET /v1/machines/{slug}/cost?hours_a_year=&diesel_inr= returns what the machine costs its owner for every hour it works: ownership (the price over its working life at the class’s resale), fuel at the power’s burn, the operator, service by the hour, and the total, at the hours a year you pass (the class default otherwise) and your diesel price. Every line names its assumption, so show the assumptions with the figure.
What operators say
GET /v1/machines/{slug}/ratings returns the month’s score per pillar (fuel an hour, uptime, service reach, operator comfort, parts prices, resale, attachments) with the count of voices behind it; a pillar under the five-voice floor is marked provisional. As with vehicles, the comments themselves, their platforms and their links stay on truckaurbus.com.
Attachments
GET /v1/machines/attachments?kind=&manufacturer= lists the attachments register (buckets, breakers, couplers, rippers and the rest) and GET /v1/machines/attachments/{slug} is one attachment with its sheet and the machines on the register it fits, by class and carrier weight. GET /v1/machines/{slug}/attachments answers the question the other way round.
The pairing
GET /v1/machines/{slug}/works-with?haul_km=&shift_hours=&density=&fill=&state= answers the question a loader’s buyer asks next: which tippers it fills, and how fast. For a loading machine (an excavator, a wheel loader, a backhoe) the answer lists tippers from the register with passes per body, loads and tonnes an hour at the haul distance (3 km by default), the shift (8 hours), the material’s density (1.6 t per cubic metre) and the bucket fill (0.9). state picks the tippers’ prices, each with its kind and its date.
The whole register as CSV
GET /v1/export/machines.csv is every published machine in one file, business and enterprise keys. The columns are in Bulk export.
Events
Enterprise keys subscribe tomachine.published, machine.updated and machine.price.changed with POST /v1/webhooks; the payloads are in Webhooks. A price event states the kind and the date of the new figure and the previous figure it replaces, never the page it was read from.