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 by confidence descending; 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

{
  "data": [
    {
      "target": {
        "firstName": "Bob",
        "lastName": "Lee",
        "title": "CEO",
        "linkedinUrl": "https://www.linkedin.com/in/boblee",
        "currentCompany": {
          "id": 123,
          "name": "Acme",
          "domain": "acme.com"
        }
      },
      "connections": [
        {
          "confidence": 0.82,
          "source": {
            "id": 42,
            "firstName": "Alice",
            "lastName": "Roe",
            "primaryEmailAddress": "alice@northpointvc.com"
          },
          "inference": {
            "sharedEmployer": {
              "id": 555,
              "name": "Globex",
              "domain": "globex.com"
            },
            "overlapStartDate": "2018-03-01",
            "overlapEndDate": "2020-11-30"
          }
        }
      ]
    }
  ],
  "pagination": {
    "prevUrl": "https://api.affinity.co/v2/foo?cursor=ICAgICAgYmVmb3JlOjo6Nw",
    "nextUrl": "https://api.affinity.co/v2/foo?cursor=ICAgICAgIGFmdGVyOjo6NA"
  }
}