> For the complete documentation index, see [llms.txt](https://docs.biobox.io/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.biobox.io/guide/how-to/ask-biobox-with-claude/tools/list-reports.md).

# list\_reports — List scoring reports

List scoring reports

List scoring reports

## What it does

List a BIPARTITE reasoning module's scoring reports — each report is one scored run of the model (e.g. "ALS", "RILUZOLE") — flagging which are archived or test reports so they can be excluded.

**When to use:** after picking a reasoning module (from list\_reasoning\_models / search\_models), to find the reportId to read ranked scores from (list\_reports → get\_report\_scores); the user wants to see which scored runs a model has, or when each report was created/updated.

**When NOT to use:** the model is a PROFILE (monopartite) model — use list\_profile\_reports; this tool 404s on a profile-model uuid; listing the MODELS themselves rather than a model's runs (use list\_reasoning\_models); you want the model's scoring criteria / config (use get\_reasoning\_model); you want the ranked scores/rows of a report you've already chosen (use get\_report\_scores).

**Parameters:**

* `modelId` — the reasoning module's id (its bipartite-subgraph uuid, from list\_reasoning\_models / search\_models) — which model's reports to list. A PROFILE model's uuid is rejected with a 404 pointing at list\_profile\_reports.
* `includeArchived` — optional. Default omitted → return ALL reports WITH their archived/isTest flags (do not drop). Pass false to ask the gateway to exclude archived reports at the source. The safe default is flag-don't-filter.

**Returns:** An object { reports, count }. Each report has: reportId (pass to get\_report\_scores — this is the key that tool consumes), displayName (the run's human name, e.g. "ALS"), anchorConcept (the concept it's anchored on, { dbLabel, displayName }), anchorObject (the anchored entity itself, { uuid, displayName } — e.g. the disease ALS), totalTargets (the number of scored objects in the report), archived + isTest (HYGIENE FLAGS), dateCreated, dateUpdated (last scored), and numberOfEvidenceLines. IMPORTANT: EXCLUDE any report with archived:true or isTest:true from user-facing answers (they exist — e.g. "Archived ALS", "TEST" — but should not be surfaced). `count` is the number returned — this is the model's FULL report inventory (it is not paginated or capped). A modelId that is not a bipartite reasoning module returns a 404 Not Found error (isError) naming list\_profile\_reports.

## Parameters

| Parameter         | Type    | Required | Description                                                                                                                                                                                                               |
| ----------------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `modelId`         | string  | yes      | the reasoning module's id (its bipartite-subgraph uuid, from list\_reasoning\_models / search\_models) — which model's reports to list. A PROFILE model's uuid is rejected with a 404 pointing at list\_profile\_reports. |
| `includeArchived` | boolean | no       | optional. Default omitted → return ALL reports WITH their archived/isTest flags (do not drop). Pass false to ask the gateway to exclude archived reports at the source. The safe default is flag-don't-filter.            |

## Response

```ts
{
  reports: Array<{
    reportId: string;
    displayName: string;
    archived: boolean;
    isTest: boolean;
    anchorConcept: {
      dbLabel: string | null;
      displayName: string | null;
    } | null;
    anchorObject: {
      uuid: string | null;
      displayName: string | null;
    } | null;
    totalTargets: number | null;
    dateCreated: string | null;
    dateUpdated: string | null;
    numberOfEvidenceLines: number | null;
  }>;
  count: number;
}
```

## Example

```json
// list_reports({"modelId":"Ok8nsoMnRLWiC_YByOslb"})
{
  "modelId": "Ok8nsoMnRLWiC_YByOslb"
}
```

Response (arrays truncated):

```json
{
  "reports": [
    {
      "reportId": "CR-Ksa7pFW1SOnDyPQ0kd",
      "displayName": "ALS",
      "archived": false,
      "isTest": false,
      "anchorConcept": {
        "dbLabel": "Disease",
        "displayName": "Disease"
      },
      "anchorObject": {
        "uuid": "MONDO:0004976",
        "displayName": "amyotrophic lateral sclerosis"
      },
      "totalTargets": 44750,
      "dateCreated": "2026-03-02T18:09:07.223Z",
      "dateUpdated": "2026-03-02T18:09:07.223Z",
      "numberOfEvidenceLines": 0
    }
  ],
  "count": 1
}
```