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

# Token Transparency Filing Questions

> One row per question in a published Token Transparency Framework filing, keyed by filing and question id: section, question label, answer type and mode, the answer as submitted, the reviewer's label and whether it counts as a gap. Filter by filingID to get one filing's answers in schema order.

| | |
| - | - |
| Access | Token-transparency-dataset |
| Tabular model | `token-transparency-filing-questions`: primary key `id` |

## Endpoints

<CardGroup cols={2}>
  <Card title="List Token Transparency Filing Questions" icon="arrow-right" href="/api-reference/data-api/token-transparency/tabular-token-transparency-filing-questions">
    One page of rows with per-column filters, sorting and pagination.
  </Card>

  <Card title="Get Token Transparency Filing Question" icon="arrow-right" href="/api-reference/data-api/token-transparency/tabular-token-transparency-filing-questions-by-id">
    One row by `id`.
  </Card>
</CardGroup>

## Columns

Use the `Field` value in `selections`, `sortBy`, and as the base of a filter parameter (`Field` plus one of its `Filters` suffixes).

| Field | Type | Filters | Sort | Description |
| - | - | - | - | - |
| `id` | string | `Eq`, `IsOneOf` | | The unique identifier of the filing question, formed from the filing id and the question id. (primary key) |
| `filingID` | string | `Eq`, `IsOneOf` | | The filing the answer belongs to. |
| `questionID` | string | `Eq`, `IsOneOf` | | The question id within the filing schema (e.g. q1). |
| `schemaID` | string | `Eq`, `IsOneOf` | | The identifier of the filing schema the question belongs to. |
| `sectionIndex` | int32 | | default | Zero-based position of the question's section in the schema. |
| `sectionName` | string | `Eq`, `IsOneOf` | | The name of the schema section the question belongs to. |
| `questionIndex` | int32 | | yes | Zero-based position of the question within its section. |
| `questionLabel` | string | | | The question as shown to the filer. |
| `answerType` | string | `Eq`, `IsOneOf` | | The answer type of the question: text or table. |
| `answerMode` | string | `Eq`, `IsOneOf` | | The layout of the answer: single, fielded, open, grid, or sectioned. |
| `answer` | object | | | The submitted answer object; its shape follows the answer type and mode, and all text values are markdown. Null when the question was not answered. |
| `label` | string | `Eq`, `IsOneOf` | | The reviewer's label for the answer: complete, partially\_complete, or incomplete; null when unlabelled. |
| `gap` | bool | `Eq` | | True when the question counts as a gap in the filing's completion. |

## Example

```bash curl theme={null}
curl "https://api.blockworks.com/query/tabular/token-transparency-filing-questions?pageSize=3&selections=id,filingID,questionID,schemaID" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"
```

See [List Token Transparency Filing Questions](/api-reference/data-api/token-transparency/tabular-token-transparency-filing-questions) for the response and the errors.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.