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

> One row per version of a Token Transparency Framework question set, keyed by schemaID: filing type, version, question count and the ordered sections with every question's label, answer type, configuration and filer instructions.

| | |
| - | - |
| Access | Token-transparency-dataset |
| Tabular model | `token-transparency-filing-schemas`: primary key `schemaID` |

## Endpoints

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

  <Card title="Get Token Transparency Filing Schema" icon="arrow-right" href="/api-reference/data-api/token-transparency/tabular-token-transparency-filing-schemas-by-id">
    One row by `schemaID`.
  </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 |
| - | - | - | - | - |
| `schemaID` | string | `Eq`, `IsOneOf` | | The unique identifier of the filing schema. (primary key) |
| `versionID` | string | `Eq`, `IsOneOf` | default | The schema version label (e.g. 2.0). |
| `filingType` | string | `Eq`, `IsOneOf` | yes | The filing type the schema applies to (e.g. B1, B2). |
| `sections` | array\_object | | | The schema's sections in order, each with its name and questions: id, label, answer type, configuration and instructions. |
| `questionCount` | int32 | | | Number of questions across all sections. |

## Example

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

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


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