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: the embed is capped at 20, whereas this endpoint pages through the full set visible to the caller.

This endpoint returns only children whose contents the caller has permission to read — a child in a record type you cannot access is omitted entirely. To enumerate every direct child's ID regardless of permission (IDs only, no fields or bodies), use the Child record IDs API instead.

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.

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:

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

{
  "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"? } }.