# List a page's record names

Every record on a page this caller may see, newest first, as its id and the text of ONE column (`?column=<columnId>`, usually the page's first column — its name). The light read for resolving or offering records by name: use it instead of reading the whole page when only ids and names are needed. A column hidden from this caller answers blank names.

Access class: `def:read`.

## Endpoint

`GET /v1/definitions/{key}/labels`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| key | path | string | Yes |
| column | query | string | No |

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "data": [
    {
      "id": "",
      "label": "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"
}
```
