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.

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