> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plyne.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started with Live Signals

> Retrieve Leads and Accounts, narrow your results, and explore their saved signal history.

Retrieve the Leads and Accounts your Signal Agents have already found. Filter saved results and explore the signals behind each record. Requests read the data available in your workspace; they do not start a new discovery run.

## 1. Choose people or companies

> [card] [Leads](https://docs.plyne.ai/signals/leads.md)
>
> Retrieve people with their role, associated Account, available AI assessment, and linked findings.

> [card] [Accounts](https://docs.plyne.ai/signals/accounts.md)
>
> Retrieve companies with their identity, available AI assessment, and linked findings.

## 2. Filter your results

Send filters in a JSON body. Start with a linked Sheet from [Signal Agents](https://docs.plyne.ai/signals/overview.md), or select records by signal type, country, dates, or AI score.

```json Example request body theme={null}
{
  "sheet_ids": ["sh_example_01"],
  "signal_types": ["hiring_signals"],
  "cursor": { "limit": 50 }
}
```

Each response contains one row per Lead or Account. Follow `cursor.next` while `cursor.has_more` is true, keeping the same filters and sort. See [Pagination and Filters](https://docs.plyne.ai/api/pagination.md) for page limits and filter behavior.

## 3. Review the evaluation and its findings

The record's `evaluation` contains its selected assessment and linked findings. Use the record's `id` with [Lead signal history](https://docs.plyne.ai/signals/lead-signals.md) or [Account signal history](https://docs.plyne.ai/signals/account-signals.md) to retrieve individual findings, including older retained results.

History can include qualified, unqualified, or unclear findings. Its entry count can differ from `signal_count`, which counts independently configured qualified sources. Source filters on a record search select matching entities; source filters on history select matching findings.

Use [Signal types](https://docs.plyne.ai/signals/types.md) to interpret the source and [Data Dictionary](https://docs.plyne.ai/api/data-dictionary.md) to understand fields, dates, missing values, and evidence links.

## 4. Review other evaluations

Use [Lead evaluations](https://docs.plyne.ai/signals/lead-evaluations.md) or [Account evaluations](https://docs.plyne.ai/signals/account-evaluations.md) to review other saved decisions and their linked findings. `evaluation.findings` is a five-finding preview; continue it through signal history using `evaluation_id` and `findings_cursor`. Plain signal history remains a separate view of saved findings across the record.


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