AFaffinity
Inferred Connections

Get Investor-Executive Inferred Connections

Changed on
⚠️ This endpoint is currently in BETA

Returns investor-executive inferred connections, 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). In this connection type the source is an investor and the target is an executive: the source invested in a company where the target was an executive.

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 company involved in the investment.

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 NameTypeDescriptionAllowed OperatorsExamples
target.currentCompany.idintegerThe 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
get/v2/inferred-connections/investor-executive-connections

Request

  • Base URL
    https://api.affinity.co
  • URL
    https://api.affinity.co/v2/inferred-connections/investor-executive-connections
  • Auth
    HTTP bearer

Query parameters

filterstring required

Filter options. At least one filter is required; the only currently supported filter is target.currentCompany.id, which narrows the targets to the one company the target person currently works at. Filtering on more than one company returns a 400.

cursorstring

Cursor for the next or previous page

limitinteger

Number of targets to include in the page

totalCountboolean

Include total count of the collection in the pagination response

Response

OK

Example response

{
  "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.92,
          "source": {
            "id": 42,
            "firstName": "Alice",
            "lastName": "Roe",
            "primaryEmailAddress": "alice@northpointvc.com"
          },
          "inference": {
            "investingFirm": {
              "id": 456,
              "name": "Sequoia",
              "domain": "sequoia.com"
            },
            "portfolioCompany": {
              "id": 123,
              "name": "Acme",
              "domain": "acme.com"
            }
          },
          "dealContext": {
            "fundingEvent": {
              "date": "2021-05-01",
              "series": "Series A",
              "amount": 15000000,
              "currencyCode": "USD"
            },
            "investor": {
              "title": "Partner",
              "startDate": "2018-06-01",
              "endDate": null,
              "company": {
                "id": 456,
                "name": "Sequoia",
                "domain": "sequoia.com"
              }
            },
            "executive": {
              "title": "CEO",
              "startDate": "2019-02-01",
              "endDate": "2022-03-31",
              "company": {
                "id": 123,
                "name": "Acme",
                "domain": "acme.com"
              }
            }
          }
        }
      ]
    }
  ],
  "pagination": {
    "prevUrl": "https://api.affinity.co/v2/foo?cursor=ICAgICAgYmVmb3JlOjo6Nw",
    "nextUrl": "https://api.affinity.co/v2/foo?cursor=ICAgICAgIGFmdGVyOjo6NA"
  }
}

Changes

  • 187749f77548Revision changes
    • breaking

      removed the required property /// from the response with the status

    • info

      added authentication authorization bad-request conflict method-not-allowed not-acceptable not-found not-implemented rate-limit server timeout unprocessable-entity unsupported-media-type validation discriminator mapping keys to the / response property for the response status

    • info

      added bad-request validation discriminator mapping keys to the / response property for the response status

    • info

      added the required property //// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status