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

# The Circle

> Questions and answers from owners, drivers and the house's own Ustad, on every key.

The Circle is where buyers ask and owners answer on truckaurbus.com. Through a key you read the board and the answers; asking and answering stay on the site, where a person signs in.

## The board

`GET /v1/circle/questions?category=&tag=&q=&unanswered=&sort=&lang=&limit=&offset=` returns the board: each question with its text, the asker's display name, the variant it is about where there is one, votes, the answer count and the date. `sort` is `new` by default; `lang` narrows to questions asked in one language (`en`, `hi`, `ta`); `unanswered=true` lists the open ones.

## One question

`GET /v1/circle/questions/{qid}?lang=` is the question with its answers, the accepted one first, and the related questions. An answer carries `by` (a display name or Ustad), `text`, `badge` and `verified` where the answerer is a verified owner, `helpful` and the date.

`GET /v1/variants/{slug}/questions?limit=` is the same for one variant: the answered questions about it, most helpful first.

```bash theme={"system"}
curl "https://api.truckaurbus.com/v1/variants/tata-motors-signa-4825-tk/questions?limit=5" \
  -H "Authorization: Bearer tab_live_..."
```

## What comes through

Answers written by members and by Ustad come through the key. An answer that quotes a comment a person made elsewhere stays on the site: it is not in the API, and the keys that would say where it was said are not either. What you read through a key is what a member or the house wrote here.