---
title: "Get Run"
method: GET
path: "/api/v1/leads/discover/runs/{run_id}"
tags: ["leads"]
---

# Get Run

`GET /api/v1/leads/discover/runs/{run_id}`

## Request

- Base URL: `https://api.nudgelink.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nudgelink.co/api/v1/leads/discover/runs/{run_id}`
- Auth: HTTP bearer

One run + all its suggestions (newest-first by score). The UI polls
this every 3 seconds while ``status == 'running'``.

## Path parameters

- `run_id` string, uuid, required

## Response `200`

Successful Response

- RunDetailOut
  - `run` RunOut, required
    - `id` string, uuid, required
    - `status` string, required
    - `target_limit` integer, required
    - `score_threshold` integer, required
    - `searched_count` integer, required
    - `scored_count` integer, required
    - `suggested_count` integer, required
    - `credits_used` integer, required
    - `queries_used` object[], nullable, required
    - `filters_used` object, nullable
    - `score_distribution` object, nullable
    - `funnel` object, nullable
    - `failure_reason` string, nullable, required
    - `created_at` string, date-time, required
    - `completed_at` string, date-time, nullable, required
    - `discovery_mode` string
    - `enriched_count` integer
    - `can_run_again` boolean
  - `suggestions` SuggestionOut[], required
    - `id` string, uuid, required
    - `run_id` string, uuid, required
    - `linkedin_url` string, required
    - `name` string, required
    - `title` string, required
    - `company` string, required
    - `location` string, required
    - `source_query` string, nullable, required
    - `relevance_score` integer, nullable, required
    - `relevance_reasoning` string, nullable, required
    - `matched_filters` object[], nullable
    - `language_matches` object[], nullable
    - `mini_bio` string, nullable
    - `company_size` string, nullable
    - `company_match` string, nullable
    - `intent_score` integer, nullable
    - `intent_reasons` string[], nullable
    - `intent_signals` object, nullable
    - `no_current_role` boolean
    - `status` string, required
    - `created_at` string, date-time, required
    - `decided_at` string, date-time, nullable, required
    - `accepted_lead_id` string, uuid, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/nudgelink/apis/nudgelink-api.md) · [All operations](https://skmtc.dev/nudgelink/apis/nudgelink-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nudgelink/apis/nudgelink-api/revisions/baa46e6db986?raw)