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

# Get Single Token Transparency Report

> Retrieve detailed transparency framework score for one project by ID

## Overview

Fetch a single token transparency report by **ID**. You can optionally expand the asset object to get full asset metadata including project name, symbol, and other details in a single request.

## Example Request

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

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

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

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

## Example Response

```json theme={null}
{
  "id": 1,
  "asset_id": 345426,
  "summary": "",
  "created_at": 1755624545,
  "updated_at": 1758051174,
  "asset": {
    "id": 345426,
    "code": "AERO",
    "title": "Aerodrome Finance",
    "slug": "aerodrome-finance",
    "tag_line": null,
    "description": "",
    "image_url": "https://coin-images.coingecko.com/coins/images/31745/large/token.png?1696530564",
    "legacy_sector": null,
    "category": null,
    "is_supported": false,
    "updated_at": 1759454337,
    "sector_id": null,
    "type": null
  },
  "project_team": {
    "rating": 10,
    "max": 10
  },
  "token_allocation": {
    "rating": 17,
    "max": 18
  },
  "market_structure": {
    "rating": 7,
    "max": 7
  },
  "financial_disclosure": {
    "rating": 4,
    "max": 5
  }
}
```

## Supported Options

| Name     | Type  | Details                                    |
| -------- | ----- | ------------------------------------------ |
| `id`     | path  | The ID of the transparency report to fetch |
| `expand` | query | Expand related data. Options: `asset`      |

## 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                     |
| `asset`                       | object | Expanded asset data (when `expand=asset` is used) |
| `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                            |

## See also

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


## OpenAPI

````yaml GET /v1/transparency/{id}
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/{id}:
    get:
      tags:
        - transparency
      summary: Get Token Transparency Report
      description: >-
        Retrieves detailed transparency framework score for a specific project
        including ratings across four key categories.
      operationId: TransparencyController_get_v1
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
        - name: expand
          required: false
          in: query
          schema:
            type: array
            items:
              type: string
              enum:
                - asset
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: e8350371-d4a6-47b8-9e28-cea2a7a011c9
              example:
                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
        '400':
          description: Bad Request
        '404':
          description: Not Found
      security:
        - x-api-key: []
components:
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````