> For the complete documentation index, see [llms.txt](https://developer.parvenu.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.parvenu.io/icp-enrichment/get-icp.md).

# Get ICP

Fetch one of your ICPs by id.

## Get ICP

<mark style="color:green;">`POST`</mark> `/get_icp`

{% hint style="info" %}
Free — no credits are charged. Scoped to the caller: another account's `icp_id` returns 404.
{% endhint %}

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

| Name      | Type    | Description                 |
| --------- | ------- | --------------------------- |
| `api_key` | string  | Your API Key.               |
| `icp_id`  | integer | The id of the ICP to fetch. |

**Response**

| Field inside `data` | Type    | Description                                    |
| ------------------- | ------- | ---------------------------------------------- |
| `id`                | integer | The ICP id.                                    |
| `name`              | string  | ICP name.                                      |
| `summary`           | string  | Plain-English summary of who the ICP targets.  |
| `nl_text`           | string  | The description the ICP was built from.        |
| `match_threshold`   | number  | Match cutoff used when scoring.                |
| `is_active`         | boolean | Whether the ICP is marked active.              |
| `params`            | object  | The structured filters parsed out of the text. |
| `created_at`        | string  | When the ICP was created.                      |
| `updated_at`        | string  | When the ICP was last changed.                 |

The record is under `data`. See [Response Format](/getting-started/response-format.md) for the fields every endpoint returns.

**Example**

{% tabs %}
{% tab title="Input" %}

```json
{
  "api_key": "your_api_key",
  "icp_id": 26
}
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "success",
  "data": {
    "id": 26,
    "name": "Sales Director Small Company",
    "summary": "Targeting sales directors in companies with more than 10 employees.",
    "nl_text": "sales director for company having more than 10 headcount",
    "match_threshold": 0.7,
    "is_active": false,
    "params": {
      "deterministic_filters": { "seniority": ["Director"], "function": ["Sales"], "company_size": ["11-50"] },
      "semantic_criteria": [ { "id": "sales_director", "weight": 1.0, "hard_requirement": true } ]
    },
    "created_at": "2026-07-20T12:00:00Z",
    "updated_at": "2026-07-20T12:00:00Z"
  },
  "credits_used": 0,
  "credits_remaining": 4005.0,
  "success": true
}
```

{% endtab %}

{% tab title="Error" %}

```json
{
  "status": "error",
  "error": {
    "code": "not_found",
    "message": "ICP not found"
  },
  "success": false
}
```

{% endtab %}
{% endtabs %}