Skip to main content
GET
List Token Transparency Filings

Authorizations

X-Blockworks-API-Key
string
header
required

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.

Query Parameters

filingIDEq
string

Filing ID equals.

filingIDIsOneOf
string[]

Filing ID is one of (comma-separated).

bwProjectIDEq
integer<int64>

Project ID equals.

bwProjectIDIsOneOf
integer<int64>[]

Project ID is one of (comma-separated).

bwProjectSlugEq
string

Project Slug equals.

bwProjectSlugIsOneOf
string[]

Project Slug is one of (comma-separated).

bwProjectSlugIsNotOneOf
string[]

Project Slug is not one of (comma-separated).

protocolNameEq
string

Protocol Name equals.

protocolNameIsOneOf
string[]

Protocol Name is one of (comma-separated).

protocolNameContains
string

Protocol Name contains (case-insensitive substring).

protocolTickerEq
string

Protocol Ticker equals.

protocolTickerIsOneOf
string[]

Protocol Ticker is one of (comma-separated).

protocolTickerIsNotOneOf
string[]

Protocol Ticker is not one of (comma-separated).

projectIDEq
string

Mapped Project ID equals.

projectIDIsOneOf
string[]

Mapped Project ID is one of (comma-separated).

projectSlugEq
string

Mapped Project Slug equals.

projectSlugIsOneOf
string[]

Mapped Project Slug is one of (comma-separated).

filingTypeEq
string

Filing Type equals.

filingTypeIsOneOf
string[]

Filing Type is one of (comma-separated).

filingTypeIsNotOneOf
string[]

Filing Type is not one of (comma-separated).

filingVersionEq
string

Filing Version equals.

filingVersionIsOneOf
string[]

Filing Version is one of (comma-separated).

schemaIDEq
string

Schema ID equals.

schemaIDIsOneOf
string[]

Schema ID is one of (comma-separated).

provenanceEq
string

Provenance equals.

provenanceIsOneOf
string[]

Provenance is one of (comma-separated).

publishAtGt
string<date-time>

Publish Time is greater than.

publishAtGte
string<date-time>

Publish Time is greater than or equal to.

publishAtLt
string<date-time>

Publish Time is less than.

publishAtLte
string<date-time>

Publish Time is less than or equal to.

dateFiledEq
string<date-time>

Date Filed equals.

dateFiledGt
string<date-time>

Date Filed is greater than.

dateFiledGte
string<date-time>

Date Filed is greater than or equal to.

dateFiledLt
string<date-time>

Date Filed is less than.

dateFiledLte
string<date-time>

Date Filed is less than or equal to.

gapCountEq
integer<int32>

Gap Count equals.

gapCountGt
integer<int32>

Gap Count is greater than.

gapCountGte
integer<int32>

Gap Count is greater than or equal to.

gapCountLt
integer<int32>

Gap Count is less than.

gapCountLte
integer<int32>

Gap Count is less than or equal to.

completionLabelEq
string

Completion Label equals.

completionLabelIsOneOf
string[]

Completion Label is one of (comma-separated).

filingTypeRankEq
integer<int32>

Filing Type Rank equals.

filingTypeRankLte
integer<int32>

Filing Type Rank is less than or equal to.

isSupersededEq
boolean

Is Superseded equals.

isLatestForTypeEq
boolean

Is Latest For Type equals.

filingStatusEq
string

Filing Status equals.

filingStatusIsOneOf
string[]

Filing Status is one of (comma-separated).

sortBy
enum<string>
default:publishAt

Field to sort by; defaults to the model's default sort column.

Available options:
bwProjectSlug,
protocolName,
filingType,
publishAt,
dateFiled,
gapCount
sortDirection
enum<string>
default:asc

Sort direction.

Available options:
asc,
desc
page
integer

1-based page number.

pageSize
integer

Rows per page (max 1000, default 100).

selections
enum<string>[]

Comma-separated fields to return; defaults to all fields.

Available options:
filingID,
bwProjectID,
bwProjectSlug,
protocolName,
protocolTicker,
projectID,
projectSlug,
projectName,
filingType,
filingVersion,
schemaID,
submissionRound,
provenance,
publishAt,
dateFiled,
questionCount,
gapCount,
completionLabel,
filingTypeRank,
isSuperseded,
isLatestForType,
filingStatus,
stalenessTTLMonths,
stalenessNextDeadline,
staticURL
acceptFormat
enum<string>
default:json

Response format, overriding the Accept header: json (default), csv, or jsonl (NDJSON). csv and jsonl return the rows as a downloadable file.

Available options:
json,
csv,
jsonl

Response

One page of matching rows, with the totals for the whole filtered set.

data
object[]
required
metadata
object
required

Pagination totals for the full filtered result set, independent of the current page.

error
string | null