---
title: "Ranked companies matching an ICP, each with evidence"
method: POST
path: "/v1/agent/events_for_icp"
---

# Ranked companies matching an ICP, each with evidence

`POST /v1/agent/events_for_icp`

## Request

- Base URL: `https://api.fundz.net`
- URL: `https://api.fundz.net/v1/agent/events_for_icp`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/fundz/apis/fundz-agent-data-api/docs/v1/agent/events_for_icp/post.ts> (a function with typed inputs; its response is checked against the schema)

Companies with recent launch-lane events matching an ICP filter. `min_signals` is the compound-signal filter and is applied AFTER evidence suppression, so a returned `signal_count` is always real.

## Request body

- EventsForIcpRequest
  - `industries` string[]
  - `states` string[]: Full state names as stored, e.g. 'California'.
  - `min_employees` integer
  - `max_employees` integer
  - `lookback_days` integer
  - `min_signals` integer
  - `limit` integer
  - `cursor` string

## Response `200`

Success.

- EventsForIcpResponse
  - `results` object[]
    - `company` object
      - `org_id` integer
      - `name` string
      - `domain` string
      - `name_agreement` integer
    - `signals` object[]
      - `type` string
      - `date` string
      - `summary` string
      - `source_url` string
      - `source_kind` string
    - `signal_count` integer
    - `last_event_at` string
    - `why_now_short` string
  - `next_cursor` string
  - `_usage` object
    - `units_charged` string
    - `units_month_to_date` string

## Other responses

- `400`: The request body is not valid JSON, or a parameter is unusable.
- `401`: No API key, or a key that is unknown, revoked or expired. A human must supply a new key; retrying will not help.
- `402`: The key's monthly unit allowance is spent. Valid key, exhausted plan — a plan change, not a new key.
- `403`: The tool exists but this key's tier may not call it.
- `404`: No such tool. Check the spelling before checking permissions.
- `429`: Per-minute rate limit exceeded. Back off and retry.
- `500`: Our fault. The call is recorded at ZERO units — we do not bill for our own failures.

## Changes

- **2026-09-07** `52b70c238bce`: 1 info
  - added the optional property `results/items/company/name_agreement` to the response with the `200` status

[Operation history](https://skmtc.dev/fundz/apis/fundz-agent-data-api/changes/v1/agent/events_for_icp/post.md)

---

[API](https://skmtc.dev/fundz/apis/fundz-agent-data-api.md) - [All operations](https://skmtc.dev/fundz/apis/fundz-agent-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fundz/apis/fundz-agent-data-api/revisions/52b70c238bce?raw)