---
title: "tool si.read.leads"
description: "Reads the leads of one brand, narrowed by a place, a condition or a user: The answer gives the leads, or the package that holds them."
section: reference
address: /reference/tools/si-read-leads
contract: 0476e35e6e275db5
---

# tool si.read.leads

Reads the leads of one brand, narrowed by a place, a condition or a user: The answer gives the leads, or the package that holds them.

[figure: Over MCP, si.read.leads takes LeadsInput and returns a card whose body is [Lead].]

The answer gives the leads, or the package that holds them. The call needs the read grant at the strategy rung.



| | |
|---|---|
| input | [LeadsInput](/concepts/leadsinput) |
| result | a card whose body is [Lead](/concepts/lead) |
| read-only | yes |
| destructive | no |
| card address | `ui://scale-intelligence/cards/Lead` |
| HTTP route | [`/v1/read/leads`](/reference/read/leads) |





| field | type | required | note |
|---|---|---|---|
| `brand` | `id` | yes |  |
| `place` | `text` | no |  |
| `condition` | [LeadCondition](/concepts/leadcondition) | no |  |
| `person` | `id` | no |  |
| `lead` | `id` | no | one lead, as its package |