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

# list_reports

> List evaluation reports

# list\_reports

List evaluation reports for your organization, sorted by date (newest first).

## Parameters

| Parameter  | Type   | Required | Description                                     |
| ---------- | ------ | -------- | ----------------------------------------------- |
| `offset`   | number | No       | Skip first N reports (default: 0)               |
| `limit`    | number | No       | Max reports to return (default: 20)             |
| `provider` | string | No       | Filter by provider name (case-insensitive)      |
| `status`   | string | No       | Filter: "published", "draft", "archived", "all" |

## Response

```json theme={null}
{
  "total": 42,
  "showing": { "offset": 0, "limit": 20, "count": 20 },
  "reports": [
    {
      "slug": "resend-com-a1b2c3d4",
      "name": "Resend — Getting Started",
      "date": "2026-04-13",
      "score": 85.5,
      "grade": "A-",
      "status": "published",
      "runType": "automated",
      "provider": "Resend"
    }
  ]
}
```