---
title: "Get a Mutual Connections signal's progress"
method: GET
path: "/api/v1/signals/{signalId}/mutual-connections"
tags: ["Signals"]
---

# Get a Mutual Connections signal's progress

`GET /api/v1/signals/{signalId}/mutual-connections`

## Request

- Base URL: `https://api.rodz.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.rodz.io/api/v1/signals/{signalId}/mutual-connections`
- Auth: HTTP bearer

See how far a Mutual Connections signal has got: how much of each of the two networks has been read, how many people were found in both, and how many have been delivered.

**Input:** `signalId` in the path.

**Output:** `profiles` (per profile: `state`, `peopleRead`), `mutualsFound`, `mutualCountKnown` — the number of mutual connections is only final once both networks have been read — and `oneTimeExtract` progress.

## Path parameters

- `signalId` string, required: Id of the Mutual Connections signal, as returned by the create endpoint.

## Response `200`

Successful Response

- object: Both profiles, the mutual connections found, and delivery progress.
  - `profiles` object[]
    - `url` string, required: The profile's LinkedIn URL, as configured.
    - `state` string, required: `waiting` (not readable yet), `reading` (their network is being read), `done` (read to the end; new connections only from now on), `not_visible` (they hide their connection list), `declined` (cannot be read).
    - `peopleRead` integer: People of this profile's network read so far.
  - `mutualsFound` integer: People found in both networks so far, before your persona filter. Grows until both networks are read.
  - `mutualCountKnown` boolean: True once both networks have been read (or cannot be).
  - `oneTimeExtract` object, nullable: `target`, `delivered`, `status` (`running` / `complete` / `none`).

## Other responses

- `404`: No Mutual Connections signal with this id on your account
- `422`: Validation Error
- `429`: Rate limit exceeded. Retry after the number of seconds in the `Retry-After` response header.

---

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