Retrieve a page

curl https://api.bottari.ai/v1/pages/exampleRow01 \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"

{
  "object": "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": "22222222-2222-4222-8222-222222222222"
  },
  "in_trash": false,
  "cover": null,
  "icon": {
    "type": "emoji",
    "emoji": "📦"
  },
  "parent": {
    "type": "data_source_id",
    "data_source_id": "exampleDb001",
    "database_id": "exampleDb001"
  },
  "is_archived": false,
  "is_locked": false,
  "properties": {
    "Name": {
      "id": "title",
      "type": "title",
      "title": [
        {
          "type": "text",
          "text": {
            "content": "Review January orders",
            "link": null
          },
          "annotations": {
            "bold": false,
            "italic": false,
            "strikethrough": false,
            "underline": false,
            "code": false,
            "color": "default"
          },
          "plain_text": "Review January orders",
          "href": null
        }
      ]
    },
    "Done": {
      "id": "exampleFld03",
      "type": "checkbox",
      "checkbox": true
    },
    "Due date": {
      "id": "exampleFld04",
      "type": "date",
      "date": {
        "start": "2026-01-31",
        "end": null,
        "time_zone": null
      }
    }
  },
  "url": "https://app.bottari.ai/t/exampleTeam1/p/exampleRow01",
  "public_url": null,
  "request_id": "33333333-3333-4333-8333-333333333333"
}

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

GET

pages

{id}

curl https://api.bottari.ai/v1/pages/exampleRow01 \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"

{
  "object": "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": "22222222-2222-4222-8222-222222222222"
  },
  "in_trash": false,
  "cover": null,
  "icon": {
    "type": "emoji",
    "emoji": "📦"
  },
  "parent": {
    "type": "data_source_id",
    "data_source_id": "exampleDb001",
    "database_id": "exampleDb001"
  },
  "is_archived": false,
  "is_locked": false,
  "properties": {
    "Name": {
      "id": "title",
      "type": "title",
      "title": [
        {
          "type": "text",
          "text": {
            "content": "Review January orders",
            "link": null
          },
          "annotations": {
            "bold": false,
            "italic": false,
            "strikethrough": false,
            "underline": false,
            "code": false,
            "color": "default"
          },
          "plain_text": "Review January orders",
          "href": null
        }
      ]
    },
    "Done": {
      "id": "exampleFld03",
      "type": "checkbox",
      "checkbox": true
    },
    "Due date": {
      "id": "exampleFld04",
      "type": "date",
      "date": {
        "start": "2026-01-31",
        "end": null,
        "time_zone": null
      }
    }
  },
  "url": "https://app.bottari.ai/t/exampleTeam1/p/exampleRow01",
  "public_url": null,
  "request_id": "33333333-3333-4333-8333-333333333333"
}

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

Reads a row or subpage. For content, use blocks or Markdown. A trashed row can still be read, and in_trash is true. The same goes for rows of a trashed database.

string

required

Bearer <token>. See Tokens.

string

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

string

required

The ID of a row or subpage.

string[]

Property names or IDs to include. An unknown property returns 400.

string

The row ID.

string

Creation time, in UTC, truncated to the minute.

string

Last edit time, in UTC, truncated to the minute.

object

{ "object": "user", "id": "..." }.

object

{ "object": "user", "id": "..." }.

boolean

true if it’s in the trash.

boolean

true if it’s archived.

boolean

true if it’s locked.

object

{ "type": "data_source_id", "data_source_id": "...", "database_id": "..." } for a row, { "type": "page_id", "page_id": "..." } for a subpage.

object | null

One of emoji, icon, custom_emoji, or file. icon.name is a Bottari icon name.

object | null

external or file. Gradient and solid covers are null.

object

Values keyed by property name. See Property values. A subpage only has title.

string | null

The address that opens it in the app.

null

Always null.

Errors

Status	`code`	Cause
400	`validation_error`	An unknown `filter_properties` value.
404	`object_not_found`	The row doesn’t exist, belongs to a database that isn’t connected, or has its own access settings.

See Common rules for shared errors.

curl https://api.bottari.ai/v1/pages/exampleRow01 \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"

{
  "object": "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": "22222222-2222-4222-8222-222222222222"
  },
  "in_trash": false,
  "cover": null,
  "icon": {
    "type": "emoji",
    "emoji": "📦"
  },
  "parent": {
    "type": "data_source_id",
    "data_source_id": "exampleDb001",
    "database_id": "exampleDb001"
  },
  "is_archived": false,
  "is_locked": false,
  "properties": {
    "Name": {
      "id": "title",
      "type": "title",
      "title": [
        {
          "type": "text",
          "text": {
            "content": "Review January orders",
            "link": null
          },
          "annotations": {
            "bold": false,
            "italic": false,
            "strikethrough": false,
            "underline": false,
            "code": false,
            "color": "default"
          },
          "plain_text": "Review January orders",
          "href": null
        }
      ]
    },
    "Done": {
      "id": "exampleFld03",
      "type": "checkbox",
      "checkbox": true
    },
    "Due date": {
      "id": "exampleFld04",
      "type": "date",
      "date": {
        "start": "2026-01-31",
        "end": null,
        "time_zone": null
      }
    }
  },
  "url": "https://app.bottari.ai/t/exampleTeam1/p/exampleRow01",
  "public_url": null,
  "request_id": "33333333-3333-4333-8333-333333333333"
}

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

Common

Users

Search

Databases and data sources

Pages

Blocks

Comments

Errors

​Errors

Errors