> ## Documentation Index
> Fetch the complete documentation index at: https://developers.bottari.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 블록 자식 읽기

> 블록의 자식을 읽습니다. 문서 ID를 넣으면 본문의 최상위 블록을 반환합니다.

블록의 바로 아래 자식을 읽습니다. 문서 ID를 넣으면 본문의 최상위 블록을 반환합니다. `has_children`이 `true`인 블록은 그 ID로 다시 호출하세요. 본문에 카드가 없는 하위 문서는 목록에 나오지 않습니다.

**Authorization** `string` *required*

`Bearer <토큰>` 형식입니다. [토큰 자세히 알아보기 →](https://developers.bottari.ai/ko/auth/tokens.md)

**Bottari-Version** `string`

선택 항목입니다. `2026-03-11`만 받습니다. 빼면 현재 버전을 사용하고, 다른 값을 보내면 400을 반환합니다.

**id** `string` *required*

문서 ID나 블록 ID입니다.

**page\_size** `number` (default: 100)

1\~100입니다.

**start\_cursor** `string`

앞 응답의 `next_cursor`입니다. 다음 목록의 첫 블록 ID입니다.

**results** `object[]`

블록 객체 목록입니다. [블록 읽기 자세히 알아보기 →](https://developers.bottari.ai/ko/api-reference/blocks/retrieve.md)

**next\_cursor** `string | null`

다음 목록의 커서입니다.

**has\_more** `boolean`

더 있으면 `true`입니다.

**type** `string`

항상 `block`입니다.

## 본문 전부 읽기

문서 ID로 이 엔드포인트를 호출한 뒤, `has_children`이 `true`인 블록마다 다시 호출하세요. 자식이 있는 블록마다 요청을 하나씩 보냅니다. 호출 횟수가 걱정되면 [마크다운 읽기](https://developers.bottari.ai/ko/api-reference/pages/markdown.md)를 사용하세요.

## 오류

| 상태 | `code` | 원인 |
| - | - | - |
| 400 | `validation_error` | `page_size`가 틀렸거나 `start_cursor`가 이 블록의 자식 ID가 아닙니다. |
| 404 | `object_not_found` | 없거나 연동이 읽을 수 없는 블록입니다. 휴지통에 있는 문서와 데이터베이스의 자식도 404입니다. |

공통 오류는 [공통 규칙](https://developers.bottari.ai/ko/api-reference/overview.md#오류)에서 확인할 수 있습니다.

```bash curl theme={null}
curl "https://api.bottari.ai/v1/blocks/exampleRow01/children?page_size=50" \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"
```

```json 200 theme={null}
{
  "object": "list",
  "results": [
    {
      "object": "block",
      "id": "exampleRow01.exampleBlk01",
      "parent": {
        "type": "page_id",
        "page_id": "exampleRow01"
      },
      "created_time": "2026-01-15T02:30:00.000Z",
      "last_edited_time": "2026-01-15T03:10:00.000Z",
      "created_by": {
        "object": "user",
        "id": "11111111-1111-4111-8111-111111111111"
      },
      "last_edited_by": {
        "object": "user",
        "id": "11111111-1111-4111-8111-111111111111"
      },
      "has_children": false,
      "in_trash": false,
      "type": "divider",
      "divider": {}
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "type": "block",
  "block": {},
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.