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

# Retrieve a block

> Read one block. Document, subpage, and inline database IDs can also be read as blocks.

Reads one block. Writing isn't available. To read children, use [List block children](https://developers.bottari.ai/api-reference/blocks/children.md).

**Authorization** `string` *required*

`Bearer <token>`. See [Tokens](https://developers.bottari.ai/auth/tokens.md).

**Bottari-Version** `string`

Optional. Only `2026-03-11` is accepted. Without it, the current version is used. A different value returns 400.

**id** `string` *required*

The block ID.

## Block IDs

| ID | Block returned |
| - | - |
| Document ID | That document's `child_page`. Its children are the content. |
| Inline or connected database ID | `child_database`, with no children. |
| Original synced block ID | That `synced_block`. Blocks inside it are `<synced block id>.<block address>`. |
| Anything else | A block in the form `<document id>.<block address>`. |

Use block IDs as you received them. Some blocks in a document nobody has opened use position-based IDs, which can change when the document is first edited.

## Block object

**id** `string`

The block ID.

**parent** `object`

One of `page_id`, `block_id`, `data_source_id`, or `workspace`.

**created\_time** `string`

The value from the block's document.

**last\_edited\_time** `string`

The value from the block's document.

**created\_by** `object`

The value from the block's document.

**last\_edited\_by** `object`

The value from the block's document.

**has\_children** `boolean`

`true` if it has children.

**in\_trash** `boolean`

`true` if its document is in the trash.

**type** `string`

The block type.

## Block types

| Group | `type` |
| - | - |
| Text | `paragraph`, `heading_1`, `heading_2`, `heading_3`, `heading_4`, `quote`, `callout`, `toggle` |
| Lists | `bulleted_list_item`, `numbered_list_item`, `to_do` |
| Code and equations | `code`, `equation` |
| Structure | `divider`, `table`, `table_row`, `column_list`, `column`, `tab`, `table_of_contents`, `breadcrumb`, `synced_block` |
| Files and links | `image`, `video`, `audio`, `pdf`, `file`, `bookmark`, `embed`, `link_to_page` |
| Children | `child_page`, `child_database` |
| No equivalent | `unsupported`, with the original type in `unsupported.block_type` |

Blocks returned as `unsupported` include buttons, Bottari notes, files that couldn't be signed, and cards for documents the integration can't read (`alias`).

Besides the rich text items used in properties, block text can include `link_preview` mentions.

## Errors

| Status | `code` | Cause |
| - | - | - |
| 404 | `object_not_found` | The block doesn't exist, or the integration can't read it. Deleted blocks also return 404. |

See [Common rules](https://developers.bottari.ai/api-reference/overview.md#errors) for shared errors.

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

```json 200 theme={null}
{
  "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": "paragraph",
  "paragraph": {
    "rich_text": [
      {
        "type": "text",
        "text": {
          "content": "Reviewed the January orders.",
          "link": null
        },
        "annotations": {
          "bold": false,
          "italic": false,
          "strikethrough": false,
          "underline": false,
          "code": false,
          "color": "default"
        },
        "plain_text": "Reviewed the January orders.",
        "href": null
      }
    ],
    "color": "default"
  },
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```

```json 404 theme={null}
{
  "object": "error",
  "status": 404,
  "code": "object_not_found",
  "message": "Could not find block with ID: exampleRow01.exampleBlk01. Make sure the relevant pages and databases are shared with your connection \"Order sync\".",
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```


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