---
title: "Get Coworker Inferred Connections"
method: GET
path: "/v2/inferred-connections/coworkers"
tags: ["Inferred Connections"]
---

# Get Coworker Inferred Connections

`GET /v2/inferred-connections/coworkers`

| ⚠️  This endpoint is currently in BETA |
|--|

Returns inferred connections based on shared work history, grouped by the target person, strongest first.

A connection is the belief that a `source` (a person in your Affinity data, with an `id`, whom you know) might know a `target` (a person not in your Affinity data, described only, whom you want to know), because the two had overlapping employment at a shared company.

The same target can be reachable through several people you know. Connections are grouped by target: each item in `data` is one target together with the `connections` to them. Within a target, connections are ordered strongest first; targets are ordered by their strongest connection, strongest first.

Each `target` carries the company they work at **today** in `target.currentCompany`: the company at which they are a potential contact now, which is not necessarily the shared employer behind the connection.

The `filter` parameter is required and must contain at least one filter. The only currently supported filter is `target.currentCompany.id`, which narrows the targets to a single such company.

## Filters

| **Property Name** | **Type** | **Description** | **Allowed Operators** | **Examples** |
|---|---|---|---|---|
| `target.currentCompany.id` | `integer` | The id of the company the `target` person currently works at. Must reference a single company; filtering on more than one (e.g. `target.currentCompany.id = 1 \| target.currentCompany.id = 2`) returns a `400`. | `=` | `target.currentCompany.id = 123` |

## Query parameters

- `filter` string, required
- `cursor` string
- `limit` integer
- `totalCount` boolean

## Response `200`

OK

- CoworkerConnectionGroupsPaged — A paginated list of shared-work-history connections grouped by target person. Each item is one target and the connections inferred to them.
  - `data` CoworkerConnectionGroup[], required — A page of targets, each with the shared-work-history connections to them, ordered by each target's strongest connection (strongest first).
    - `target` InferredConnectionTarget, required — The `target` of an inferred connection: the person who is not in your Affinity data, described only (no `id`). Includes the company they currently work at, where they are a potential contact now.
      - `fullName` string, nullable, required — The person's full name, or `null` when not known.
      - `title` string, nullable, required — The person's current job title, or `null` when not known.
      - `linkedinUrl` string, nullable, required — A link to the person's LinkedIn profile, or `null` when not known.
      - `currentCompany` InferredConnectionCompanyRef, required — A reference to a company that appears in an inferred connection.
        - `id` integer, required — The company's unique identifier.
        - `name` string, nullable, required — The company's name.
        - `domain` string, nullable, required — The company's primary domain, or `null` when not known.
    - `connections` CoworkerConnection[], required — The shared-work-history connections to this target, ordered strongest first.
      - `source` RelationshipPerson, required — A person involved in a relationship, including basic identifying information.
        - `id` integer, required — The person's unique identifier
        - `firstName` string, nullable, required — The person's first name
        - `lastName` string, nullable, required — The person's last name
        - `primaryEmailAddress` string, email, nullable, required — The person's primary email address
      - `inference` CoworkerInference, required — The belief that the source and target worked together: they were employed at the same company at the same time. The `sharedEmployer` is that company; `overlapStartDate` and `overlapEndDate` bound the period their employment overlapped.
        - `sharedEmployer` InferredConnectionCompanyRef, required — A reference to a company that appears in an inferred connection.
          - `id` integer, required — The company's unique identifier.
          - `name` string, nullable, required — The company's name.
          - `domain` string, nullable, required — The company's primary domain, or `null` when not known.
        - `overlapStartDate` string, date, required — The first date on which the source and target were both employed at the `sharedEmployer`.
        - `overlapEndDate` string, date, required — The last date on which the source and target were both employed at the `sharedEmployer`.
  - `pagination` PaginationWithTotalCount, required
    - `prevUrl` string, uri, nullable — URL for the previous page
    - `nextUrl` string, uri, nullable — URL for the next page

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `default` — Errors

---

[API](https://skmtc.net/affinity/apis/affinity-api-v2.md) · [All operations](https://skmtc.net/affinity/apis/affinity-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/affinity/affinity-api-v2/revisions/4c2891c31b7f/schema)