TokenTransparencyFilingsRow

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/blockworks/main/json-schema/blockworks-token-transparency-filings-row-schema.json",
  "title": "TokenTransparencyFilingsRow",
  "x-generated": "2026-09-29",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/data-api-openapi.json#/components/schemas/TokenTransparencyFilingsRow",
  "properties": {
    "bwProjectID": {
      "description": "The Blockworks research project id the filing belongs to.",
      "format": "int64",
      "type": [
        "integer",
        "null"
      ]
    },
    "bwProjectSlug": {
      "description": "The Blockworks research project slug, used to group filings by project and in the filing's static URL.",
      "type": [
        "string",
        "null"
      ]
    },
    "completionLabel": {
      "description": "Completion label derived from the gap count: complete, or partial with the number of gaps.",
      "type": [
        "string",
        "null"
      ]
    },
    "dateFiled": {
      "description": "The UTC date the filing was published.",
      "format": "date-time",
      "type": [
        "string",
        "null"
      ]
    },
    "filingID": {
      "description": "The unique identifier of the filing.",
      "type": [
        "string",
        "null"
      ]
    },
    "filingStatus": {
      "description": "current, or stale when the filing is superseded or past its staleness deadline.",
      "type": [
        "string",
        "null"
      ]
    },
    "filingType": {
      "description": "The filing type (e.g. B1, B2).",
      "type": [
        "string",
        "null"
      ]
    },
    "filingTypeRank": {
      "description": "Rank of the filing among the project's filings of the same type, newest first; 1 is the latest.",
      "format": "int32",
      "type": [
        "integer",
        "null"
      ]
    },
    "filingVersion": {
      "description": "The version of the filing schema the filing was answered against (e.g. 2.0).",
      "type": [
        "string",
        "null"
      ]
    },
    "gapCount": {
      "description": "Number of questions with a gap: unanswered, unscored, or scored below complete.",
      "format": "int32",
      "type": [
        "integer",
        "null"
      ]
    },
    "isLatestForType": {
      "description": "True for the newest filing of each type per project; filter on it to get one filing per type.",
      "type": [
        "boolean",
        "null"
      ]
    },
    "isSuperseded": {
      "description": "True when a newer filing of the same type exists for the project.",
      "type": [
        "boolean",
        "null"
      ]
    },
    "projectID": {
      "description": "The identifier of the mapped project record, when the research project is mapped to one.",
      "type": [
        "string",
        "null"
      ]
    },
    "projectName": {
      "description": "The name of the mapped project record, when the research project is mapped to one.",
      "type": [
        "string",
        "null"
      ]
    },
    "projectSlug": {
      "description": "The project's slug elsewhere in the API, when the research project is mapped to a project record.",
      "type": [
        "string",
        "null"
      ]
    },
    "protocolName": {
      "description": "The display name of the project's protocol.",
      "type": [
        "string",
        "null"
      ]
    },
    "protocolTicker": {
      "description": "The asset ticker of the project's protocol; null when the project has no asset.",
      "type": [
        "string",
        "null"
      ]
    },
    "provenance": {
      "description": "Who compiled the filing: issuer-filed or blockworks-compiled.",
      "type": [
        "string",
        "null"
      ]
    },
    "publishAt": {
      "description": "When the filing was published, in UTC.",
      "format": "date-time",
      "type": [
        "string",
        "null"
      ]
    },
    "questionCount": {
      "description": "Number of questions in the filing's schema.",
      "format": "int32",
      "type": [
        "integer",
        "null"
      ]
    },
    "schemaID": {
      "description": "The identifier of the filing schema, joinable to the Token Transparency Filing Schemas model.",
      "type": [
        "string",
        "null"
      ]
    },
    "stalenessNextDeadline": {
      "description": "The next recurring deadline after the filing date, for filing types governed by deadline rules; the filing goes stale once it passes.",
      "format": "date-time",
      "type": [
        "string",
        "null"
      ]
    },
    "stalenessTTLMonths": {
      "description": "Months after the filing date before the filing goes stale, for filing types governed by a time-to-live rule.",
      "format": "int32",
      "type": [
        "integer",
        "null"
      ]
    },
    "staticURL": {
      "description": "The public URL of the filing on blockworks.com.",
      "type": [
        "string",
        "null"
      ]
    },
    "submissionRound": {
      "description": "The submission round that was published.",
      "format": "int32",
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "type": "object"
}