---
title: Child records
url: https://www.tines.com/stories/docs/api/records/child_records/
updated: 2026-09-23T08:49:51+00:00
description: List the records whose parent is the given record, newest first. Results are keyset-paginated.
---

*[tines.com](https://www.tines.com/llms.txt) › [Docs](https://www.tines.com/stories/docs/llms.txt) › [Tines API](https://www.tines.com/stories/docs/api/llms.txt) › [Records](https://www.tines.com/llm/stories/docs/api/records.md)*

# Child records

*[View on tines.com](https://www.tines.com/stories/docs/api/records/child_records/)*

## Description

List the records whose parent is the given record, newest first. Results are keyset-paginated.

This is the paged equivalent of the `child_records` embed on the [Get record API](/api/records/get): the embed is capped at 20, whereas this endpoint pages through the full set visible to the caller.

## Request

HTTP Method: **GET**

| Path parameter | Description                  |
| -------------- | ---------------------------- |
| id             | The ID of the parent record. |

| Query parameter | Description                                                                                      |
| --------------- | ------------------------------------------------------------------------------------------------ |
| timezone        | **Optional** IANA timezone name for timestamp output. Defaults to UTC.                           |
| limit           | **Optional** Page size, between 1 and 500. Defaults to 20.                                       |
| after           | **Optional** Opaque forward pagination cursor from a previous response's `page.next_page_token`. |

```bash
curl -X GET \
  https://<tenant-domain>/api/v2/records/<<record_id>>/child_records \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>'
```

### Pagination

When more results exist, the response's `page` object contains a `next_page_token`; pass it back as the `after` query parameter to fetch the next page. On the last page, `page` has no `next_page_token`.

## Response

A successful request returns a JSON object with a `data` array of record bodies and a `page` pagination cursor.

### Field description

Each object in `data` has the same shape as a record from the [Get record API](/api/records/get):

| Field         | Description                                                                                                                                                                      |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id            | Integer ID of the record.                                                                                                                                                        |
| fields        | Field values keyed by field slug. Scalar fields hold their typed value; `TIMESTAMP` fields are ISO 8601 strings; artifact-backed fields return an `{ expandable, href }` handle. |
| relationships | `record_type` (`{ "id" }`) and `parent_record` (`{ "id" }`) — here, the parent record you queried.                                                                               |
| created_at    | ISO 8601 creation timestamp (UTC unless a `timezone` is supplied).                                                                                                               |
| updated_at    | ISO 8601 last-updated timestamp (UTC unless a `timezone` is supplied).                                                                                                           |

The `page` object contains a `next_page_token` when another page exists.

### Sample response

```json
{
  "data": [
    {
      "id": 556,
      "fields": {
        "status": "closed"
      },
      "relationships": {
        "record_type": {
          "id": 42
        },
        "parent_record": {
          "id": 555
        }
      },
      "created_at": "2026-07-02T00:00:00Z",
      "updated_at": "2026-07-02T00:00:00Z"
    }
  ],
  "page": {}
}
```

## Errors

| Status | Meaning                                                                                |
| ------ | -------------------------------------------------------------------------------------- |
| 400    | Invalid request — unknown query parameter, invalid timezone, limit, or `after` cursor. |
| 403    | The tenant does not have access to records.                                            |
| 404    | Record not found.                                                                      |

Errors are returned as `{ "error": { "type", "message", "field"?, "hint"? } }`.