LEleadfeeder
Ideal Customer Profiles
v1

Retrieve Ideal Customer Profiles

Changed on

Retrieve all Ideal Customer Profiles (ICPs) defined in the account. Each ICP is a saved set of company-level filter criteria (employee count, industry, location) used to identify target companies. relationships.custom_feed links an ICP to the Web Visits custom feed created alongside it, which lists the visiting companies matching the ICP; it is null for the few ICPs that have no feed.

Credit Note: Retrieving ICP definitions does not consume credits.

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

get/v1/icps

Request

  • Base URL
    https://api.leadfeeder.com
  • URL
    https://api.leadfeeder.com/v1/icps
  • 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.

Response

Success

Example response

{
  "data": [
    {
      "attributes": {
        "created_at": "2024-12-10T15:57:25Z",
        "filters": {
          "employee_count": [
            {
              "display_value": "United States",
              "search_value": "US"
            }
          ],
          "industries": [
            {
              "display_value": "United States",
              "search_value": "US"
            }
          ],
          "location": [
            {
              "display_value": "United States",
              "search_value": "US",
              "type": "country_code"
            }
          ]
        },
        "name": "US Prospects"
      },
      "id": "6080",
      "relationships": {
        "custom_feed": {
          "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "type": "custom_feed"
        }
      },
      "type": "icp"
    }
  ],
  "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