Skip to main content
GET
List Research Reports

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

reportIDEq
string

Report ID equals.

reportIDIsOneOf
string[]

Report ID is one of (comma-separated).

titleEq
string

Title equals.

titleIsOneOf
string[]

Title is one of (comma-separated).

titleContains
string

Title contains (case-insensitive substring).

slugEq
string

Slug equals.

slugIsOneOf
string[]

Slug is one of (comma-separated).

slugContains
string

Slug contains (case-insensitive substring).

publishDateEq
string<date-time>

Publish Date equals.

publishDateGt
string<date-time>

Publish Date is greater than.

publishDateGte
string<date-time>

Publish Date is greater than or equal to.

publishDateLt
string<date-time>

Publish Date is less than.

publishDateLte
string<date-time>

Publish Date is less than or equal to.

createdAtGt
string<date-time>

Created At is greater than.

createdAtGte
string<date-time>

Created At is greater than or equal to.

createdAtLt
string<date-time>

Created At is less than.

createdAtLte
string<date-time>

Created At is less than or equal to.

updatedAtGt
string<date-time>

Updated At is greater than.

updatedAtGte
string<date-time>

Updated At is greater than or equal to.

updatedAtLt
string<date-time>

Updated At is less than.

updatedAtLte
string<date-time>

Updated At is less than or equal to.

readingTimeInMinutesGt
number

Reading Time In Minutes is greater than.

readingTimeInMinutesGte
number

Reading Time In Minutes is greater than or equal to.

readingTimeInMinutesLt
number

Reading Time In Minutes is less than.

readingTimeInMinutesLte
number

Reading Time In Minutes is less than or equal to.

subscriptionTierEq
string

Subscription Tier equals.

subscriptionTierIsOneOf
string[]

Subscription Tier is one of (comma-separated).

subscriptionTierIsNotOneOf
string[]

Subscription Tier is not one of (comma-separated).

reportTypeEq
string

Report Type equals.

reportTypeIsOneOf
string[]

Report Type is one of (comma-separated).

reportTypeIsNotOneOf
string[]

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

categoryEq
string

Category equals.

categoryIsOneOf
string[]

Category is one of (comma-separated).

categoryIsNotOneOf
string[]

Category is not one of (comma-separated).

assetIDsIncludes
string

Asset IDs array includes.

assetIDsNotIncludes
string

Asset IDs array does not include.

assetIDsIncludesAnyOf
string[]

Asset IDs array includes any of (comma-separated).

assetIDsNotIncludesAnyOf
string[]

Asset IDs array includes none of (comma-separated).

authorNamesIncludes
string

Author Names array includes.

authorNamesNotIncludes
string

Author Names array does not include.

authorNamesIncludesAnyOf
string[]

Author Names array includes any of (comma-separated).

authorNamesNotIncludesAnyOf
string[]

Author Names array includes none of (comma-separated).

tagNamesIncludes
string

Tag Names array includes.

tagNamesNotIncludes
string

Tag Names array does not include.

tagNamesIncludesAnyOf
string[]

Tag Names array includes any of (comma-separated).

tagNamesNotIncludesAnyOf
string[]

Tag Names array includes none of (comma-separated).

sortBy
enum<string>
default:publishDate

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

Available options:
title,
publishDate,
createdAt,
updatedAt,
readingTimeInMinutes
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:
reportID,
title,
slug,
hook,
summary,
content,
publishDate,
createdAt,
updatedAt,
readingTimeInMinutes,
subscriptionTier,
reportType,
category,
previewImageURL,
assetIDs,
assets,
authorNames,
authors,
tagNames,
tags
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