---
title: "tool si.read.candidates"
description: "Reads the candidates of one brand, narrowed by a buyer profile or by a place: Each candidate arrives with the signals gathered about it, the rung it has reached, and what it still lacks to qualify."
section: reference
address: /reference/tools/si-read-candidates
contract: 0476e35e6e275db5
---

# tool si.read.candidates

Reads the candidates of one brand, narrowed by a buyer profile or by a place: Each candidate arrives with the signals gathered about it, the rung it has reached, and what it still lacks to qualify.

[figure: Over MCP, si.read.candidates takes CandidatesInput and returns a card whose body is [Candidate].]

Each candidate arrives with the signals gathered about it, the rung it has reached, and what it still lacks to qualify. The call needs the read grant at the strategy rung.



| | |
|---|---|
| input | [CandidatesInput](/concepts/candidatesinput) |
| result | a card whose body is [Candidate](/concepts/candidate) |
| read-only | yes |
| destructive | no |
| card address | `ui://scale-intelligence/cards/Candidate` |
| HTTP route | [`/v1/read/candidates`](/reference/read/candidates) |





| field | type | required | note |
|---|---|---|---|
| `brand` | `id` | yes |  |
| `kind_of_buyer` | `id` | no |  |
| `place` | `text` | no |  |
| `candidate` | `id` | no | one candidate |