---
title: "Only the companies in your book with new events since a cursor"
method: POST
path: "/v1/agent/watchlist_diff"
---

# Only the companies in your book with new events since a cursor

`POST /v1/agent/watchlist_diff`

## Request

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

The recurring primitive: send up to 400 domains and a cursor, get back only those with new evidence. Domains beyond the cap are returned in `not_checked` rather than silently dropped.

## Request body

- WatchlistDiffRequest
  - `domains` string[], required
  - `since` string, date: The `next_cursor` from your previous call.

## Response `200`

Success.

- WatchlistDiffResponse
  - `changed` object[]
    - `domain` string
    - `org_id` integer
    - `name` string
    - `new_events` object[]
      - `type` string
      - `date` string
      - `summary` string
      - `source_url` string
      - `source_kind` string
      - `sec_items` string[]
  - `next_cursor` string
  - `checked` integer
  - `unresolved` unknown[]
    - unknown
  - `served_from` string
  - `not_checked` unknown[]
    - unknown
  - `_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.

---

[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)