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

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



## OpenAPI

````yaml api-reference/data-api/openapi.json GET /query/tabular/token-transparency-filing-questions
openapi: 3.0.0
info:
  description: >-
    The Blockworks Data API is a unified, read-only REST interface to
    Blockworks' warehouse-modeled crypto dataset, powered by Messari's research
    and data infrastructure. It serves two kinds of models: tabular models,
    which return current, filterable, sortable rows for entities such as assets,
    networks, protocols, exchanges, stablecoins, and ETFs; and timeseries
    models, which return historical metric series at a chosen granularity for
    one or many entities. Every endpoint shares the same query grammar (column
    projection, per-column filters, sorting, and pagination) and returns the
    standard `{ "error": ..., "data": ... }` envelope. Authenticate by sending
    your API key in the `X-Blockworks-API-Key` header.
  title: Blockworks Data API
  version: 0.1.0
servers:
  - description: Blockworks API
    url: https://api.blockworks.com
security:
  - apiKey: []
tags:
  - description: 'Models documented under Acquisitions: Acquisition Deals (table).'
    name: Acquisitions
  - description: >-
      Models documented under Assets: Assets (table), Asset Marketcap
      (timeseries), Asset Price (timeseries), Asset Sharpe (timeseries), Asset
      Supply (timeseries), Asset Volatility (timeseries).
    name: Assets
  - description: >-
      Models documented under Blockchains: Blockchains (table), Blockchains
      (timeseries).
    name: Blockchains
  - description: >-
      Models documented under Derivatives: Perpetual Markets (table), Perpetual
      Markets (timeseries).
    name: Derivatives
  - description: >-
      Models documented under Digital Asset Treasuries: DAT Companies (table),
      DAT Company Assets (table), DAT Companies (timeseries), DAT Companies by
      Asset (timeseries).
    name: Digital Asset Treasuries
  - description: >-
      Models documented under ETFs: ETF Assets (table), ETF Providers (table),
      ETF Assets (timeseries), ETF Providers (timeseries).
    name: ETFs
  - description: >-
      Models documented under Exchanges: Exchange Country (timeseries), Exchange
      Region (timeseries), Exchange Type (timeseries), Exchanges (timeseries).
    name: Exchanges
  - description: >-
      Models documented under Funding Rounds: Funding Round Investors (table),
      Funding Rounds (table), Sector Fundraising (timeseries).
    name: Funding Rounds
  - description: >-
      Models documented under Funds & Investors: Fund Managers (table), Funds
      (table).
    name: Funds & Investors
  - description: >-
      Models documented under Launchpads: Launchpad Chains (table), Launchpads
      (table), Launchpads (timeseries), Launchpads by Chain (timeseries).
    name: Launchpads
  - description: >-
      Models documented under Lending Protocols: Lending Protocol Product
      Markets (table), Lending Protocol Products (table), Lending Protocols
      (table), Lending Protocols (timeseries), Lending Protocols by Product
      (timeseries), Lending Protocols by Product Market (timeseries).
    name: Lending Protocols
  - description: >-
      Models documented under Market Overview: Sector Marketdata (timeseries),
      Sub-Sector Marketdata (timeseries).
    name: Market Overview
  - description: 'Models documented under Markets: Market (BQEN) (timeseries).'
    name: Markets
  - description: >-
      Models documented under News & Research: News Feed (table), Research
      Reports (table), Topics (timeseries).
    name: News & Research
  - description: >-
      Models documented under Perp DEXes: Perp DEX Protocols (table), Perp DEX
      Protocols (timeseries).
    name: Perp DEXes
  - description: 'Models documented under Projects & Entities: Projects (timeseries).'
    name: Projects & Entities
  - description: >-
      Models documented under Protocol Revenue: Protocol Revenue (timeseries),
      Protocol Revenue by Product (timeseries).
    name: Protocol Revenue
  - description: >-
      Models documented under Social & Mindshare: Asset Group Sentiment
      (timeseries), Asset Investor Mentions (timeseries), Asset Mindshare
      (timeseries), Asset Sentiment (timeseries), Project Mindshare
      (timeseries), Sector Asset Mindshare (timeseries), Sector Asset Sentiment
      (timeseries), Sector Investor Mentions (timeseries), Sub-Sector Asset
      Mindshare (timeseries), Sub-Sector Asset Sentiment (timeseries).
    name: Social & Mindshare
  - description: >-
      Models documented under Spot DEXes: Spot DEX Protocol Chains (table), Spot
      DEX Protocols (table), Spot DEX Protocols (timeseries), Spot DEX Protocols
      by Chain (timeseries).
    name: Spot DEXes
  - description: >-
      Models documented under Stablecoins: Stablecoin Chains (table), Stablecoin
      Currencies (table), Stablecoin FX Pairs (table), Stablecoin Issuers
      (table), Stablecoin Products (table), Stablecoin Reserve Entities (table),
      Stablecoin FX (timeseries), Stablecoin Reserves (timeseries), Stablecoins
      by Chain (timeseries), Stablecoins by Currency (timeseries), Stablecoins
      by Issuer (timeseries), Stablecoins by Product (timeseries).
    name: Stablecoins
  - description: >-
      Models documented under TCG Platforms: TCG Platform Chains (table), TCG
      Platforms by Chain (timeseries).
    name: TCG Platforms
  - description: >-
      Discovery of the tabular models: one row per entity, with per-column
      filters, sorting and pagination.
    name: Tabular
  - description: >-
      Discovery of the timeseries models: one series per entity, as points at
      the granularities each model declares.
    name: Timeseries
  - description: >-
      Models documented under Token Transparency Framework: Token Transparency
      Filing Questions (table), Token Transparency Filing Schemas (table), Token
      Transparency Filings (table), Token Transparency Projects (table).
    name: Token Transparency Framework
  - description: >-
      Models documented under Tokenized Commodities: Tokenized Commodities
      (table), Tokenized Commodity Chains (table), Tokenized Commodity Issuers
      (table), Tokenized Commodity Products (table), Tokenized Commodities by
      Chain (timeseries), Tokenized Commodities by Commodity (timeseries),
      Tokenized Commodities by Issuer (timeseries), Tokenized Commodities by
      Product (timeseries).
    name: Tokenized Commodities
  - description: >-
      Models documented under Tokenized Equities: Tokenized Equities (table),
      Tokenized Equity Chains (table), Tokenized Equity Issuers (table),
      Tokenized Equity Products (table), Tokenized Equities by Chain
      (timeseries), Tokenized Equities by Equity (timeseries), Tokenized
      Equities by Issuer (timeseries), Tokenized Equities by Product
      (timeseries).
    name: Tokenized Equities
  - description: >-
      Models documented under Vaults: Vault Chains (table), Vault Curators
      (table), Vault Protocols (table), Vault Curators (timeseries), Vault
      Protocols (timeseries), Vaults by Chain (timeseries).
    name: Vaults
paths:
  /query/tabular/token-transparency-filing-questions:
    get:
      tags:
        - Token Transparency Framework
      summary: List Token Transparency Filing Questions
      description: >-
        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.
      operationId: getTabular_token_transparency_filing_questions
      parameters:
        - description: ID equals.
          in: query
          name: idEq
          schema:
            type: string
        - description: ID is one of (comma-separated).
          in: query
          name: idIsOneOf
          schema:
            items:
              type: string
            type: array
        - description: Filing ID equals.
          in: query
          name: filingIDEq
          schema:
            type: string
        - description: Filing ID is one of (comma-separated).
          in: query
          name: filingIDIsOneOf
          schema:
            items:
              type: string
            type: array
        - description: Question ID equals.
          in: query
          name: questionIDEq
          schema:
            type: string
        - description: Question ID is one of (comma-separated).
          in: query
          name: questionIDIsOneOf
          schema:
            items:
              type: string
            type: array
        - description: Schema ID equals.
          in: query
          name: schemaIDEq
          schema:
            type: string
        - description: Schema ID is one of (comma-separated).
          in: query
          name: schemaIDIsOneOf
          schema:
            items:
              type: string
            type: array
        - description: Section Name equals.
          in: query
          name: sectionNameEq
          schema:
            type: string
        - description: Section Name is one of (comma-separated).
          in: query
          name: sectionNameIsOneOf
          schema:
            items:
              type: string
            type: array
        - description: Answer Type equals.
          in: query
          name: answerTypeEq
          schema:
            type: string
        - description: Answer Type is one of (comma-separated).
          in: query
          name: answerTypeIsOneOf
          schema:
            items:
              type: string
            type: array
        - description: Answer Mode equals.
          in: query
          name: answerModeEq
          schema:
            type: string
        - description: Answer Mode is one of (comma-separated).
          in: query
          name: answerModeIsOneOf
          schema:
            items:
              type: string
            type: array
        - description: Label equals.
          in: query
          name: labelEq
          schema:
            type: string
        - description: Label is one of (comma-separated).
          in: query
          name: labelIsOneOf
          schema:
            items:
              type: string
            type: array
        - description: Gap equals.
          in: query
          name: gapEq
          schema:
            type: boolean
        - description: Field to sort by; defaults to the model's default sort column.
          in: query
          name: sortBy
          schema:
            default: sectionIndex
            enum:
              - sectionIndex
              - questionIndex
            type: string
        - description: Sort direction.
          in: query
          name: sortDirection
          schema:
            default: asc
            enum:
              - asc
              - desc
            type: string
        - description: 1-based page number.
          in: query
          name: page
          schema:
            type: integer
        - description: Rows per page (max 1000, default 100).
          in: query
          name: pageSize
          schema:
            type: integer
        - description: Comma-separated fields to return; defaults to all fields.
          in: query
          name: selections
          schema:
            items:
              enum:
                - id
                - filingID
                - questionID
                - schemaID
                - sectionIndex
                - sectionName
                - questionIndex
                - questionLabel
                - answerType
                - answerMode
                - answer
                - label
                - gap
              type: string
            type: array
        - description: >-
            Response format, overriding the Accept header: json (default), csv,
            or jsonl (NDJSON). csv and jsonl return the rows as a downloadable
            file.
          in: query
          name: acceptFormat
          schema:
            default: json
            enum:
              - json
              - csv
              - jsonl
            type: string
      responses:
        '200':
          content:
            application/json:
              example:
                data:
                  - answer: {}
                    answerMode: <answerMode>
                    answerType: <answerType>
                    filingID: <filingID>
                    gap: true
                    id: <id>
                    label: <label>
                    questionID: <questionID>
                    questionIndex: 123
                    questionLabel: <questionLabel>
                    schemaID: <schemaID>
                    sectionIndex: 123
                    sectionName: <sectionName>
                error: null
                metadata:
                  totalPages: 1
                  totalRows: 1
              schema:
                properties:
                  data:
                    items:
                      $ref: '#/components/schemas/TokenTransparencyFilingQuestionsRow'
                    type: array
                  error:
                    nullable: true
                    type: string
                  metadata:
                    description: >-
                      Pagination totals for the full filtered result set,
                      independent of the current page.
                    properties:
                      totalPages:
                        format: int64
                        type: integer
                      totalRows:
                        format: int64
                        type: integer
                    required:
                      - totalRows
                      - totalPages
                    type: object
                required:
                  - data
                  - metadata
                type: object
            application/x-ndjson:
              schema:
                description: JSON Lines (NDJSON); one JSON object per line.
                type: string
            text/csv:
              schema:
                description: CSV with a header row; one row per record.
                type: string
          description: >-
            One page of matching rows, with the totals for the whole filtered
            set.
        '400':
          content:
            application/json:
              example:
                data: null
                error: unknown query parameter "id"
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            The request is malformed: an unknown query parameter (a filter needs
            its operator suffix, such as idEq), a filter value of the wrong
            type, a sortBy field that is not sortable, an unknown selections
            field, or a pageSize above 1000.
        '401':
          content:
            application/json:
              example:
                data: null
                error: this model requires authentication
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: No API key was sent and the model requires one.
        '403':
          content:
            application/json:
              example:
                data: null
                error: >-
                  this model requires the "token_transparency_framework_unified"
                  permission
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            The API key is not valid, or does not hold the
            "token_transparency_framework_unified" permission.
        '404':
          content:
            application/json:
              example:
                data: null
                error: tabular model "unknown-model" not found
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            The path names a model that does not exist: the slug is mistyped or
            the model was removed.
components:
  schemas:
    TokenTransparencyFilingQuestionsRow:
      properties:
        answer:
          description: >-
            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.
          nullable: true
          type: object
        answerMode:
          description: 'The layout of the answer: single, fielded, open, grid, or sectioned.'
          nullable: true
          type: string
        answerType:
          description: 'The answer type of the question: text or table.'
          nullable: true
          type: string
        filingID:
          description: The filing the answer belongs to.
          nullable: true
          type: string
        gap:
          description: True when the question counts as a gap in the filing's completion.
          nullable: true
          type: boolean
        id:
          description: >-
            The unique identifier of the filing question, formed from the filing
            id and the question id.
          nullable: true
          type: string
        label:
          description: >-
            The reviewer's label for the answer: complete, partially_complete,
            or incomplete; null when unlabelled.
          nullable: true
          type: string
        questionID:
          description: The question id within the filing schema (e.g. q1).
          nullable: true
          type: string
        questionIndex:
          description: Zero-based position of the question within its section.
          format: int32
          nullable: true
          type: integer
        questionLabel:
          description: The question as shown to the filer.
          nullable: true
          type: string
        schemaID:
          description: The identifier of the filing schema the question belongs to.
          nullable: true
          type: string
        sectionIndex:
          description: Zero-based position of the question's section in the schema.
          format: int32
          nullable: true
          type: integer
        sectionName:
          description: The name of the schema section the question belongs to.
          nullable: true
          type: string
      type: object
    ErrorResponse:
      properties:
        data:
          description: Always null on an error.
          nullable: true
          type: object
        error:
          description: What went wrong, in one sentence.
          type: string
      required:
        - error
        - data
      type: object
  securitySchemes:
    apiKey:
      description: >-
        API key sent in the `X-Blockworks-API-Key` header; `x-messari-api-key`
        is accepted for existing integrations. The catalog endpoints and models
        on the public access tier need no key.
      in: header
      name: X-Blockworks-API-Key
      type: apiKey

````