---
title: "List matched signal companies"
method: GET
path: "/lists/{listID}/signals/companies"
tags: ["signals"]
---

# List matched signal companies

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

## Request

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

Paginated matched companies from the latest completed extraction, with include/total counts and a hasMore flag.

## Path parameters

- `listID` string, required

## Query parameters

- `offset` integer
- `limit` integer, required

## Response `200`

Matched companies page

- ListSignalCompaniesResponse
  - `companies` SignalCompanyResponse[]
    - `companyId` string
    - `country` string
    - `includeInFilter` boolean
    - `logo` string
    - `name` string
    - `signals` object[]
    - `website` string
  - `companiesSelected` integer
  - `companiesTotal` integer
  - `hasMore` boolean

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `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)