---
title: "Leads Status"
method: GET
path: "/v1/leads/{job_id}"
tags: ["leads"]
---

# Leads Status

`GET /v1/leads/{job_id}`

## Request

- Base URL: `https://api.snoopscan.com`
- URL: `https://api.snoopscan.com/v1/leads/{job_id}`
- Auth: none declared

Get a Find Leads run: its status, its leads and a summary.

While `status` is `running`, `partial` is true and `leads` holds the leads
found so far, without contacts yet. Once `completed`, the leads are final.
A run stopped with DELETE is `cancelled` and keeps the leads it had,
charged as usual. `summary.attribution` lists any license notices the
leads carry: show each one with the results and in every export.

## Path parameters

- `job_id` string, required

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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