# List a record's subrecords

Every child record hanging under this one — a deal's contacts, a merchant's locations — whichever page each is on, in section order. Each link carries the child's page key, row id, cells (masked by the CHILD page's own column policy) and the section it is drawn in. Reach for this to answer 'what does this record hold'.

Access class: `def:read`.

## Endpoint

`GET /v1/definitions/{key}/rows/{rowId}/subrecords`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| key | path | string | Yes |
| rowId | 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": [
    "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"
}
```