# Get a published Report

`GET /v3/reports/{id}`

Full report artifact: body, typed sources, and the publication-time
evidence block. Requires the `topic-reports` entitlement. The
evidence block quotes market figures with source attribution as
part of the published research.

## Authentication

Required. Send an API key in the `x-api-key` header.
Required account access: `topic-reports`.

## Parameters

```json
[
  {
    "name": "id",
    "in": "path",
    "required": true,
    "schema": {
      "type": "string"
    }
  }
]
```

## Request body

None.

## Responses

```json
{
  "200": {
    "description": "Report detail.",
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "data",
            "meta"
          ],
          "properties": {
            "data": {
              "$ref": "#/components/schemas/Report"
            },
            "meta": {
              "$ref": "#/components/schemas/Meta"
            }
          }
        },
        "examples": {
          "success": {
            "summary": "Full report",
            "value": {
              "data": {
                "id": "tr_9f2b6c41d8a35e07b1c4f6a2d5e8091c3b7a4f60d2e5c8b1a4f7092c5d8e3b6a",
                "title": "Restaking Yield Compression",
                "publishedAt": "2026-08-04T18:00:00Z",
                "revisedAt": null,
                "primarySubject": {
                  "type": "topic",
                  "topic": {
                    "id": "topic_a1b2c3d4e5f601234567",
                    "name": "Restaking yield compression"
                  }
                },
                "relatedSubjects": [
                  {
                    "type": "project",
                    "project": {
                      "id": "665f0a2b1c9d440000a1b2c3",
                      "slug": "examplechain",
                      "name": "ExampleChain"
                    }
                  }
                ],
                "summary": "Yields across restaking protocols compress as new AVS demand stalls.",
                "body": "## Thesis\n\nYields compress because...",
                "sources": [
                  {
                    "title": "AVS demand dashboard",
                    "url": "https://dune.com/example/avs",
                    "publishedAt": "2026-08-03T00:00:00Z"
                  }
                ],
                "evidence": {
                  "snapshotAt": "2026-08-04T18:00:00Z",
                  "entities": [
                    {
                      "project": {
                        "id": "665f0a2b1c9d440000a1b2c3",
                        "slug": "examplechain",
                        "name": "ExampleChain"
                      },
                      "observations": [
                        {
                          "key": "avs_count",
                          "value": 41,
                          "unit": "count",
                          "provider": "aixbt",
                          "observedAt": "2026-08-04T17:58:00Z",
                          "freshness": "fresh"
                        }
                      ]
                    }
                  ]
                }
              },
              "meta": {}
            }
          }
        }
      }
    }
  },
  "400": {
    "$ref": "#/components/responses/BadRequest"
  },
  "401": {
    "$ref": "#/components/responses/Unauthorized"
  },
  "403": {
    "$ref": "#/components/responses/Forbidden"
  },
  "404": {
    "$ref": "#/components/responses/SubjectMiss"
  },
  "429": {
    "$ref": "#/components/responses/RateLimited"
  },
  "500": {
    "$ref": "#/components/responses/Internal"
  }
}
```

## Referenced schemas

```json
{
  "Report": {
    "allOf": [
      {
        "$ref": "#/components/schemas/ReportListItem"
      },
      {
        "type": "object",
        "required": [
          "summary",
          "body",
          "sources"
        ],
        "properties": {
          "summary": {
            "type": "string"
          },
          "body": {
            "type": "string",
            "description": "Markdown body of the published artifact without internal source-id markers."
          },
          "sources": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "title",
                "url"
              ],
              "properties": {
                "title": {
                  "type": "string"
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "publishedAt": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          },
          "evidence": {
            "type": "object",
            "description": "Publication-time evidence quoted by the artifact, with source\nattribution and observation timestamps. Immutable once\npublished.\n",
            "properties": {
              "snapshotAt": {
                "type": "string",
                "format": "date-time"
              },
              "entities": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "project",
                    "observations"
                  ],
                  "properties": {
                    "project": {
                      "$ref": "#/components/schemas/ProjectRef"
                    },
                    "observations": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "key",
                          "value",
                          "unit",
                          "provider",
                          "observedAt",
                          "freshness"
                        ],
                        "properties": {
                          "key": {
                            "type": "string"
                          },
                          "value": {
                            "type": "number"
                          },
                          "unit": {
                            "type": "string"
                          },
                          "provider": {
                            "type": "string"
                          },
                          "observedAt": {
                            "description": "Source-side observation timestamp. Null when\nthe provider publishes the figure without\none.\n",
                            "oneOf": [
                              {
                                "type": "string",
                                "format": "date-time"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "freshness": {
                            "type": "string"
                          },
                          "disagreement": {
                            "type": "number"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    ]
  },
  "ReportListItem": {
    "type": "object",
    "required": [
      "id",
      "title",
      "publishedAt",
      "primarySubject",
      "preview"
    ],
    "properties": {
      "id": {
        "type": "string"
      },
      "title": {
        "type": "string"
      },
      "publishedAt": {
        "type": "string",
        "format": "date-time"
      },
      "revisedAt": {
        "oneOf": [
          {
            "type": "string",
            "format": "date-time"
          },
          {
            "type": "null"
          }
        ]
      },
      "primarySubject": {
        "$ref": "#/components/schemas/ReportSubject"
      },
      "relatedSubjects": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/ReportSubject"
        },
        "description": "Ordered, deduplicated Project bindings frozen from the Report's evidence membership and resolved to current Project identity; never inferred from prose, live Topic associations, or market evidence."
      },
      "preview": {
        "type": "string"
      }
    }
  },
  "ReportSubject": {
    "type": "object",
    "required": [
      "type"
    ],
    "properties": {
      "type": {
        "type": "string",
        "enum": [
          "project",
          "topic"
        ]
      },
      "project": {
        "$ref": "#/components/schemas/ProjectRef"
      },
      "topic": {
        "$ref": "#/components/schemas/TopicRef"
      }
    }
  },
  "ProjectRef": {
    "type": "object",
    "required": [
      "id",
      "slug",
      "name"
    ],
    "properties": {
      "id": {
        "type": "string"
      },
      "slug": {
        "type": "string",
        "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
        "maxLength": 64
      },
      "name": {
        "type": "string"
      }
    }
  },
  "TopicRef": {
    "type": "object",
    "required": [
      "id",
      "name"
    ],
    "properties": {
      "id": {
        "type": "string"
      },
      "name": {
        "type": "string"
      }
    }
  },
  "Meta": {
    "type": "object",
    "description": "Response metadata. Empty when nothing applies.",
    "properties": {
      "history": {
        "$ref": "#/components/schemas/HistoryMeta"
      },
      "versions": {
        "type": "object",
        "additionalProperties": {
          "type": "string"
        },
        "description": "Named component versions that shaped this response."
      }
    }
  },
  "HistoryMeta": {
    "type": "object",
    "description": "The history window applied to this response. Both fields are null when the account has no history limit.",
    "required": [
      "lookbackDays",
      "earliestAvailableAt"
    ],
    "properties": {
      "lookbackDays": {
        "oneOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ]
      },
      "earliestAvailableAt": {
        "oneOf": [
          {
            "type": "string",
            "format": "date-time"
          },
          {
            "type": "null"
          }
        ]
      }
    }
  }
}
```

Schema references resolve against the [canonical OpenAPI specification](https://api.aixbt.tech/v3/openapi.yaml).