---
title: "tool si.read.withheld"
description: "Reads the withheld count for one brand or one tenant: The answer gives the count by buyer profile and temperature, with the period and the limit it was read against."
section: reference
address: /reference/tools/si-read-withheld
contract: 0476e35e6e275db5
---

# tool si.read.withheld

Reads the withheld count for one brand or one tenant: The answer gives the count by buyer profile and temperature, with the period and the limit it was read against.

[figure: Over MCP, si.read.withheld takes WithheldInput and returns a card whose body is WithheldCount.]

The answer gives the count by buyer profile and temperature, with the period and the limit it was read against. The call needs the read grant at the brand rung.



| | |
|---|---|
| input | [WithheldInput](/concepts/withheldinput) |
| result | a card whose body is [WithheldCount](/concepts/withheldcount) |
| read-only | yes |
| destructive | no |
| card address | `ui://scale-intelligence/cards/WithheldCount` |
| HTTP route | [`/v1/read/withheld`](/reference/read/withheld) |





| field | type | required | note |
|---|---|---|---|
| `brand` | `id` | no |  |
| `tenant` | `id` | no |  |
| `period` | [Window](/concepts/window) | yes |  |