> ## 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.

# 데이터베이스 읽기

> 데이터베이스 객체를 읽습니다. 속성 정의는 데이터 소스에 있습니다.

데이터베이스의 이름 · 부모 · 아이콘 · 표지를 읽습니다. 속성 정의는 [데이터 소스 읽기](https://developers.bottari.ai/ko/api-reference/data-sources/retrieve.md)로 읽으세요. Bottari 데이터베이스에는 데이터 소스가 항상 하나이고 ID가 같습니다.

휴지통에 있는 데이터베이스도 연결되어 있으면 읽을 수 있습니다. `in_trash`는 `true`입니다.

**Authorization** `string` *required*

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

**Bottari-Version** `string`

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

**id** `string` *required*

데이터베이스 ID입니다.

**id** `string`

데이터베이스 ID입니다.

**title** `object[]`

이름입니다. 텍스트 조각 배열입니다.

**description** `object[]`

설명입니다. 텍스트 조각 배열입니다.

**parent** `object`

인라인 데이터베이스는 `{ "type": "page_id", "page_id": "..." }`이고, 그 밖에는 `{ "type": "workspace", "workspace": true }`입니다.

**is\_inline** `boolean`

인라인 데이터베이스면 `true`입니다.

**in\_trash** `boolean`

휴지통에 있으면 `true`입니다. 휴지통에 있는 문서 안의 인라인 데이터베이스도 `true`입니다. 휴지통에 있는 데이터베이스의 행 안에 있는 인라인 데이터베이스는 `false`이고, 그 데이터 소스는 `true`입니다.

**is\_locked** `boolean`

잠겨 있으면 `true`입니다.

**data\_sources** `object[]`

항상 항목 하나입니다. `id`는 데이터베이스 ID와 같습니다.

**url** `string | null`

앱에서 여는 주소입니다.

**public\_url** `null`

항상 `null`입니다.

## 오류

| 상태 | `code` | 원인 |
| - | - | - |
| 404 | `object_not_found` | 없거나 연결하지 않은 데이터베이스입니다. |

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

```bash curl theme={null}
curl https://api.bottari.ai/v1/databases/exampleDb001 \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"
```

```json 200 theme={null}
{
  "object": "database",
  "id": "exampleDb001",
  "title": [
    {
      "type": "text",
      "text": {
        "content": "주문",
        "link": null
      },
      "annotations": {
        "bold": false,
        "italic": false,
        "strikethrough": false,
        "underline": false,
        "code": false,
        "color": "default"
      },
      "plain_text": "주문",
      "href": null
    }
  ],
  "description": [],
  "parent": {
    "type": "workspace",
    "workspace": true
  },
  "is_inline": false,
  "in_trash": false,
  "is_locked": false,
  "database_type": null,
  "show_data_source_title": false,
  "created_time": "2026-01-10T01:00:00.000Z",
  "last_edited_time": "2026-01-15T03:10:00.000Z",
  "data_sources": [
    {
      "id": "exampleDb001",
      "name": "주문"
    }
  ],
  "icon": null,
  "cover": null,
  "url": "https://app.bottari.ai/t/exampleTeam1/db/exampleDb001",
  "public_url": null,
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```

```json 404 theme={null}
{
  "object": "error",
  "status": 404,
  "code": "object_not_found",
  "message": "Could not find database with ID: exampleDb001. Make sure the relevant pages and databases are shared with your connection \"주문 동기화\".",
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```


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