v3

OpenAPI 3.1.1mit2026-07-3165481.5 MB
Ideal Customer Profiles
v1

Get Ideal Customer Profile Details

Get the details of a specific Ideal Customer Profile (ICP) by ID, including its name, creation timestamp, and the full set of filter criteria that define it.

Credit Note: Retrieving an ICP definition does not consume credits.

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

get/v1/icps/{id}

Path parameters

idstring required

The ICP ID.

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": {
    "type": "icp",
    "id": "6080",
    "attributes": {
      "name": "US Prospects",
      "created_at": "2024-12-10T15:57:25Z",
      "filters": {
        "employee_count": [
          {
            "search_value": "US",
            "display_value": "United States"
          }
        ],
        "industries": [
          {
            "search_value": "US",
            "display_value": "United States"
          }
        ],
        "location": [
          {
            "search_value": "US",
            "display_value": "United States"
          }
        ]
      }
    }
  },
  "meta": {
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}