> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockworksresearch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Token Transparency Reports

> Retrieve a paginated list of token transparency framework scores and ratings

## Overview

This endpoint returns a **paginated list of token transparency framework reports**, with scores across four key categories: Project & Team, Token Allocation, Market Structure, and Financial Disclosure.
This powers the [Token Transparency](http://blockworks.co//token-transparency) page on the Blockworks website.

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.blockworks.com/v1/transparency?limit=20"
  ```

  ```typescript TypeScript theme={null}
  const response = await fetch(
    'https://api.blockworks.com/v1/transparency?limit=20',
    { headers: { 'x-api-key': 'YOUR_API_KEY' } }
  )
  const data = await response.json()
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.blockworks.com/v1/transparency',
      headers={'x-api-key': 'YOUR_API_KEY'},
      params={'limit': 20}
  )
  data = response.json()
  ```
</CodeGroup>

### Example Response

A successful response returns a paginated list of transparency reports.

```json theme={null}
{
  "data": [
    {
      "id": 1,
      "asset_id": 345426,
      "summary": "",
      "created_at": 1755624545,
      "updated_at": 1758051174,
      "project_team": {
        "rating": 10,
        "max": 10
      },
      "token_allocation": {
        "rating": 17,
        "max": 18
      },
      "market_structure": {
        "rating": 7,
        "max": 7
      },
      "financial_disclosure": {
        "rating": 4,
        "max": 5
      }
    },
    {
      "id": 2,
      "asset_id": 345837,
      "summary": null,
      "created_at": 1755624584,
      "updated_at": 1755624584,
      "project_team": {
        "rating": 10,
        "max": 10
      },
      "token_allocation": {
        "rating": 18,
        "max": 18
      },
      "market_structure": {
        "rating": 7,
        "max": 7
      },
      "financial_disclosure": {
        "rating": 4,
        "max": 5
      }
    }
  ],
  "total": 27,
  "page": 1
}
```

## Supported Options

| Name        | Type  | Details                                                    | Available Options                                                                                      |
| ----------- | ----- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `expand`    | query | Expand related data.                                       | `asset`                                                                                                |
| `limit`     | query | The number of reports to return (max: 100, default: 100)   | `1-100`                                                                                                |
| `page`      | query | The page number to return.                                 | any numeric value                                                                                      |
| `order_by`  | query | Field to order results by.                                 | `asset.title`, `project_team`, `token_allocation`, `market_structure`, `financial_disclosure`, `total` |
| `order_dir` | query | Order direction for results. Default is `asc` (ascending). | `asc`, `desc`                                                                                          |

## Response Fields

| Field                         | Type   | Description                            |
| ----------------------------- | ------ | -------------------------------------- |
| `id`                          | number | Unique report identifier               |
| `asset_id`                    | number | Associated asset identifier            |
| `summary`                     | string | Report summary text                    |
| `created_at`                  | number | Unix timestamp when report was created |
| `updated_at`                  | number | Unix timestamp of last update          |
| `project_team`                | object | Project & Team category scores         |
| `project_team.rating`         | number | Score achieved in this category        |
| `project_team.max`            | number | Maximum possible score                 |
| `token_allocation`            | object | Token Allocation category scores       |
| `token_allocation.rating`     | number | Score achieved in this category        |
| `token_allocation.max`        | number | Maximum possible score                 |
| `market_structure`            | object | Market Structure category scores       |
| `market_structure.rating`     | number | Score achieved in this category        |
| `market_structure.max`        | number | Maximum possible score                 |
| `financial_disclosure`        | object | Financial Disclosure category scores   |
| `financial_disclosure.rating` | number | Score achieved in this category        |
| `financial_disclosure.max`    | number | Maximum possible score                 |

## Related Endpoints

* [Get Single Token Transparency](/api-reference/token-transparency/get-single)
* [List Assets](/api-reference/assets/list)


## OpenAPI

````yaml GET /v1/transparency
openapi: 3.0.0
info:
  title: Blockworks API
  description: ''
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.blockworks.com
security:
  - x-api-key: []
tags: []
paths:
  /v1/transparency:
    get:
      tags:
        - transparency
      summary: List Token Transparency Reports
      description: >-
        Returns a paginated list of token transparency framework reports with
        scores across four key categories.
      operationId: TransparencyController_list_v1
      parameters:
        - name: page
          required: false
          in: query
          schema:
            minimum: 1
            maximum: 2147483647
            default: 1
            type: integer
        - name: limit
          required: false
          in: query
          schema:
            minimum: 1
            maximum: 100
            default: 100
            type: integer
        - name: expand
          required: false
          in: query
          schema:
            type: array
            items:
              type: string
              enum:
                - asset
        - name: query
          required: false
          in: query
          schema:
            maxLength: 65535
            format: json
            type: string
        - name: order_by
          required: false
          in: query
          schema:
            default: id
            type: string
        - name: order_dir
          required: false
          in: query
          schema:
            default: asc
            enum:
              - asc
              - desc
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: e21bc8c9-53e9-43c5-a8a0-d253eff46850
              example:
                data:
                  - id: 1
                    asset_id: 345426
                    summary: ''
                    created_at: 1755624545
                    updated_at: 1758051174
                    project_team:
                      rating: 10
                      max: 10
                    token_allocation:
                      rating: 17
                      max: 18
                    market_structure:
                      rating: 7
                      max: 7
                    financial_disclosure:
                      rating: 4
                      max: 5
                total: 27
                page: 1
        '400':
          description: Bad Request
      security:
        - x-api-key: []
components:
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````