LEleadfeeder
Ideal Customer Profiles
v1

Retrieve Company ICP Matches

Changed on

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

Request

  • Base URL
    https://api.leadfeeder.com
  • URL
    https://api.leadfeeder.com/v1/icps/companies
  • Auth
    • API key in header X-Api-Key
    • or OAuth 2
      Authorization code: https://api.leadfeeder.com/v1/oauth/authorize
      Token URL: https://api.leadfeeder.com/v1/oauth/token scopes: icps:read

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": [
    {
      "id": "129011",
      "relationships": {
        "icps": [
          {
            "id": "6080",
            "type": "icp"
          }
        ]
      },
      "type": "company"
    }
  ],
  "meta": {
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}

Changes

  • 09a5f5bf0a85Revision changes
    • info

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

  • ac752c6c2be0Revision changes
    • info

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

    • info

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

    • info

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

    • info

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

    • info

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

    • info

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