Ideal Customer Profiles
v1

Retrieve Company ICP Matches

Find out which Ideal Customer Profiles each of your companies matches. Pass up to 100 company IDs in ids and get one entry per company, in the same order.

A company that matches no ICP keeps its place in the response with an empty list. Companies unknown to Leadfeeder are reported the same way.

Each entry names the matched ICPs by ID. Pass include=icps to get each ICP's full details instead — the same fields Retrieve Ideal Customer Profiles returns — so you do not need a second call to resolve names. An ICP matched by several of the requested companies is repeated under each of them.

Credit Note: Retrieving ICP matches does not consume credits.

:::info Requires the icps:read OAuth2 scope. :::

post/v1/icps/companies

Query parameters

account_idstring required

The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.

include'icps'

Pass icps to include each ICP's full details in the response instead of bare references.

Request body

idsstring[] required

Company IDs to look up. A maximum of 100 IDs can be passed.

Example request

{
  "ids": [
    "159001425"
  ]
}

Response

Company ICP matches retrieved

Example response

{
  "data": [
    {
      "type": "company",
      "id": "129011",
      "relationships": {
        "icps": [
          {
            "type": "icp",
            "id": "6080"
          }
        ]
      }
    }
  ],
  "meta": {
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}

Changes

No changes recorded. 1 of the 17 revisions has no diff computed, so it could not be searched.