# List the custom boards

Every board the person may see — a table with its own columns and rows — with its access and view.

Access class: `workspace`.

## Endpoint

`GET /v1/boards`

## 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": [
    {
      "access": "string",
      "columns": [
        {
          "calculation": "string",
          "config": {},
          "id": "",
          "kind": "string",
          "label": "string",
          "options": [
            {
              "groupLabel": "string",
              "id": "",
              "label": "string",
              "position": 1.5,
              "tone": "string",
              "value": "string"
            }
          ],
          "position": 1.5,
          "starred": true
        }
      ],
      "createdAt": "string",
      "definitionKey": "string",
      "id": "",
      "name": "string",
      "purpose": "string",
      "rows": [
        {
          "cells": {
            "<uuid-13>": "string",
            "<uuid-14>": "string",
            "<uuid-1>": "string"
          },
          "createdBy": "string",
          "id": "",
          "position": 1.5
        }
      ],
      "updatedAt": "string",
      "view": "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"
}
```