> ## 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 property value

> Read all of one property's value. Use it for relations and original rollup values over 25 items.

Reads one property value. Use it to read the full `relation` or original rollup values that a [row response](https://developers.bottari.ai/api-reference/pages/retrieve.md) cuts off.

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

**property\_id** `string` *required*

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

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

1 to 100, for types returned as a list.

**start\_cursor** `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](https://developers.bottari.ai/api-reference/overview.md#errors) for shared errors.

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

```json 200 list theme={null}
{
  "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"
}
```

```json 200 value theme={null}
{
  "object": "property_item",
  "type": "number",
  "id": "exampleFld02",
  "number": 3,
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```

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


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