Retrieve a property value

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

{
  "object": "list",
  "results": [
    {
      "object": "property_item",
      "type": "relation",
      "id": "exampleFld05",
      "relation": {
        "id": "exampleRow02"
      }
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "type": "property_item",
  "property_item": {
    "id": "exampleFld05",
    "next_url": null,
    "type": "relation",
    "relation": {}
  },
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "property_item",
  "type": "number",
  "id": "exampleFld02",
  "number": 3,
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "error",
  "status": 404,
  "code": "object_not_found",
  "message": "Could not find property with ID: exampleFld05.",
  "request_id": "33333333-3333-4333-8333-333333333333"
}

GET

pages

{id}

properties

{property_id}

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

{
  "object": "list",
  "results": [
    {
      "object": "property_item",
      "type": "relation",
      "id": "exampleFld05",
      "relation": {
        "id": "exampleRow02"
      }
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "type": "property_item",
  "property_item": {
    "id": "exampleFld05",
    "next_url": null,
    "type": "relation",
    "relation": {}
  },
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "property_item",
  "type": "number",
  "id": "exampleFld02",
  "number": 3,
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "error",
  "status": 404,
  "code": "object_not_found",
  "message": "Could not find property with ID: exampleFld05.",
  "request_id": "33333333-3333-4333-8333-333333333333"
}

Reads one property value. Use it to read the full relation or original rollup values that a row response cuts off.

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 row ID.

string

required

The property ID. The title is title. A property name also works.

number

default:"100"

1 to 100, for types returned as a list.

string

next_cursor from the previous response.

Response

title, rich_text, relation, people, and rollup come back as a list. Other types come back as a single value.

Response	Fields
Single value	`object: "property_item"`, `type`, `id`, and the value
List	`object: "list"`, `results`, `next_cursor`, `has_more`, `type: "property_item"`, `property_item`

In a list, property_item has id, next_url, and type. For a rollup, it also has the computed information, and each original value is in results. The id of a rollup item is the ID of the property the rollup collects.

Errors

Status	`code`	Cause
400	`validation_error`	`page_size` or `start_cursor` is wrong.
404	`object_not_found`	The row or property doesn’t exist. A subpage only has `title`.

See Common rules for shared errors.

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

{
  "object": "list",
  "results": [
    {
      "object": "property_item",
      "type": "relation",
      "id": "exampleFld05",
      "relation": {
        "id": "exampleRow02"
      }
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "type": "property_item",
  "property_item": {
    "id": "exampleFld05",
    "next_url": null,
    "type": "relation",
    "relation": {}
  },
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "property_item",
  "type": "number",
  "id": "exampleFld02",
  "number": 3,
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "error",
  "status": 404,
  "code": "object_not_found",
  "message": "Could not find property with ID: exampleFld05.",
  "request_id": "33333333-3333-4333-8333-333333333333"
}

Common

Users

Search

Databases and data sources

Pages

Blocks

Comments

Response

Errors

​Response

​Errors

Response

Errors