# Read a page's definition: its columns, statuses and roles

One record page by key, with its columns (ids, kinds, options), statuses and saved views. The schema a row's cells are keyed by.

Access class: `workspace`.

## Endpoint

`GET /v1/definitions/{key}`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| key | path | string | Yes |
| 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": [
      {
        "alignEnd": true,
        "calculation": "string",
        "config": {
          "bands": [
            {
              "tone": "string",
              "upTo": 1.5
            }
          ],
          "definitionKey": "string",
          "object": "string"
        },
        "defaultEnabled": true,
        "id": "",
        "kind": "string",
        "label": "string",
        "minWidth": 1.5,
        "position": 1.5,
        "priority": 1.5,
        "source": "string",
        "starred": true
      }
    ],
    "createdAt": "string",
    "icon": "string",
    "id": "",
    "key": "string",
    "name": "string",
    "object": "string",
    "pack": "string",
    "position": 1.5,
    "recordsEnabled": true,
    "statuses": [
      {
        "groupLabel": "string",
        "id": "",
        "isActive": true,
        "isTerminal": true,
        "label": "string",
        "position": 1.5,
        "tone": "string",
        "value": "string"
      }
    ],
    "tagsEnabled": true,
    "templateKey": "string",
    "updatedAt": "string",
    "views": [
      {
        "columnIds": [
          "string"
        ],
        "filter": {},
        "id": "",
        "key": "string",
        "label": "string",
        "position": 1.5,
        "scope": "string",
        "sort": {}
      }
    ]
  }
}
```

### 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"
}
```