Retrieve Company ICP Matches

POST

/v1/icps/companies

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.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Query Params

Body Params application/jsonRequired

Example

{
    "ids": [
        "159001425",
        "129011"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.leadfeeder.com/v1/icps/companies?account_id=123456&include=undefined' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "ids": [
        "159001425",
        "129011"
    ]
}'

Responses

🟢200OK

application/json

Company ICP matches retrieved

Bodyapplication/json

Examples

Default — the ICPs a company matches, by IDWith include=icps — each ICP in full

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

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429

🔴500Server Error

🔴504Gateway Timeout

Modified at 2026-08-31 12:06:53

Delete an Ideal Customer Profile

Retrieve Tags