---
title: "Get signal extraction status"
method: GET
path: "/lists/{listID}/signals/status"
tags: ["signals"]
---

# Get signal extraction status

`GET /lists/{listID}/signals/status`

## Request

- Base URL: `https://api.leadsforge.ai`
- URL: `https://api.leadsforge.ai/lists/{listID}/signals/status`
- Auth: API key in header `Authorization`

Poll extraction progress — returns job status and counter fields

## Path parameters

- `listID` string, required

## Response `200`

Extraction status

- ExtractionStatusResponse
  - `status` 'pending' | 'in_progress' | 'post_fetch_processing' | 'completed' | 'failed'
  - `totalExpected` integer
  - `totalFetched` integer
  - `totalMatched` integer
  - `totalUnmatched` integer

## Other responses

- `404`: No extraction job for list
- `500`: Internal Server Error

---

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