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