> ## 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\_framework\_unified                 |
| 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-framework/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-framework/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-framework/tabular-token-transparency-filing-questions) for the response and the errors.