# The saved reports

The reports saved on the Reports page — the caller's own plus the ones shared with the workspace, built-ins first — with their names, descriptions and definitions. NOT the numbers: nothing is cached, so the figures come from `post_reports_views_id_run`. A fresh workspace's four built-in reports are seeded on the first look, so this is never empty.

Access class: `workspace`.

## Endpoint

`GET /v1/reports/views`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| body | query | null | No |
| params | query | object | No |
| query | query | object | No |

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "views": [
      {
        "created_at": "string",
        "definition": {
          "dimensions": [
            {
              "field": "string",
              "period": "string"
            }
          ],
          "filters": [
            {
              "field": "string",
              "op": "string"
            }
          ],
          "measures": [
            {
              "agg": "string",
              "field": "string"
            }
          ],
          "source": "string"
        },
        "description": "string",
        "id": 1.5,
        "is_system": true,
        "name": "string",
        "owner_user_id": 1.5,
        "updated_at": "string",
        "visibility": "string"
      }
    ]
  }
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```