---
title: "tool si.read.basket"
description: "the basket, and one subject, a set of subjects, a scope predicate or a cut into groups, with the window: the basket reading as a fact: memberships with their scale of association and likelihood for one subject; population readings and co-membership for a set; proxy against group with lift and control for groups."
section: reference
address: /reference/tools/si-read-basket
contract: 0476e35e6e275db5
---

# tool si.read.basket

the basket, and one subject, a set of subjects, a scope predicate or a cut into groups, with the window: the basket reading as a fact: memberships with their scale of association and likelihood for one subject; population readings and co-membership for a set; proxy against group with lift and control for groups.

[figure: Over MCP, si.read.basket takes BasketReadInput and returns a card whose body is BasketReading.]

the basket reading as a fact: memberships with their scale of association and likelihood for one subject; population readings and co-membership for a set; proxy against group with lift and control for groups. The call needs the read grant at the strategy rung.



| | |
|---|---|
| input | [BasketReadInput](/concepts/basketreadinput) |
| result | a card whose body is [BasketReading](/concepts/basketreading) |
| read-only | yes |
| destructive | no |
| card address | `ui://scale-intelligence/cards/BasketReading` |
| HTTP route | [`/v1/read/basket`](/reference/read/basket) |





| field | type | required | note |
|---|---|---|---|
| `basket` | `id` | yes |  |
| `subject` | `id` | no | one subject |
| `subjects` | `[id]` | no | a set, under the size bound |
| `scope` | [Predicate](/concepts/predicate) | no | a population by predicate |
| `resolution` | `share` | no | a cut into groups at this resolution |
| `window` | [Window](/concepts/window) | no |  |