IdeaPulleyDocs
GuidesAPI referenceOpenAPI
Open app
  • Introduction
Get started
  • Authentication
  • API basics
  • Errors
  • Rate limits
Endpoints
  • Fund
  • Deals
  • Memos
  • Notes
  • Decisions and outcomes
  • Contacts and reports
  • Evaluations
  • Webhooks
  • More endpoints
Guides
  • Application form
  • Webhook events
  • Claude and ChatGPT (MCP)
  • Zapier, n8n and Polytomic
API basics

API basics

The rules that each endpoint follows: one base URL, one fund for each key, cursor pages, and safe retries.

Base URL

https://www.ideapulley.com/api/v2

The machine-readable spec is at /api/v2/openapi.json (OpenAPI 3.1). A typed TypeScript client is in @ideapulley/sdk.

The fund

A key acts in one fund. GET /fund tells you which, as firm/fund (for example northwind/ii). You can name the fund in the IdeaPulley-Fund header or the ?fund= parameter. Any fund other than the key's own gets a 404.

Pagination

Lists answer with this shape:

{
  "data": [ … ],
  "next_cursor": "eyJpZCI6NDJ9",
  "has_more": true
}
ParameterMeaning
limitItems on a page, 1 to 200. Default 50.
cursorThe next_cursor from the last page.
updated_sinceUnix seconds. Only items made or changed at or after this time. Use it for incremental syncs.

The evaluation routes are older and use page and limit instead.

Safe retries

Send an Idempotency-Key header on a POST. A retry with the same key and body gets the first answer again, with the header Idempotent-Replayed: true, for 24 hours. The same key with a different body gets a 409.

cURL
curl -X POST https://www.ideapulley.com/api/v2/deals/42/notes \
  -H "Authorization: Bearer $IDEAPULLEY_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: note-42-1" \
  -d '{"content":"Met the founder. Strong on distribution."}'

Endpoints

FundGet the fund · Get usage · List membersDealsList deals · Create a deal · Get a deal · List the ranked queue · List companies · Get the founder brief · Get thesis fitMemosList memo versions · Get a memo versionNotesList notes · Add a noteDecisions and outcomesList decisions · Record a decision · List decision reasons · List outcomes · Record an outcomeContacts and reportsList contacts · List LP reports · Get an LP reportEvaluationsList evaluations · Start an evaluation · Get an evaluation · Change an evaluation · Find an evaluation · List alertsWebhooksList webhooks · Add a webhook · Get a webhook · Delete a webhook · Send a test event · List deliveriesMore endpointslistSavedSearches · getSavedSearchNetNew · runFolio · getResearch
IdeaPulleyDocs
GuidesAPI referenceOpenAPI
Open app
  • Introduction
Get started
  • Authentication
  • API basics
  • Errors
  • Rate limits
Endpoints
  • Fund
  • Deals
  • Memos
  • Notes
  • Decisions and outcomes
  • Contacts and reports
  • Evaluations
  • Webhooks
  • More endpoints
Guides
  • Application form
  • Webhook events
  • Claude and ChatGPT (MCP)
  • Zapier, n8n and Polytomic
API basics

API basics

The rules that each endpoint follows: one base URL, one fund for each key, cursor pages, and safe retries.

Base URL

https://www.ideapulley.com/api/v2

The machine-readable spec is at /api/v2/openapi.json (OpenAPI 3.1). A typed TypeScript client is in @ideapulley/sdk.

The fund

A key acts in one fund. GET /fund tells you which, as firm/fund (for example northwind/ii). You can name the fund in the IdeaPulley-Fund header or the ?fund= parameter. Any fund other than the key's own gets a 404.

Pagination

Lists answer with this shape:

{
  "data": [ … ],
  "next_cursor": "eyJpZCI6NDJ9",
  "has_more": true
}
ParameterMeaning
limitItems on a page, 1 to 200. Default 50.
cursorThe next_cursor from the last page.
updated_sinceUnix seconds. Only items made or changed at or after this time. Use it for incremental syncs.

The evaluation routes are older and use page and limit instead.

Safe retries

Send an Idempotency-Key header on a POST. A retry with the same key and body gets the first answer again, with the header Idempotent-Replayed: true, for 24 hours. The same key with a different body gets a 409.

cURL
curl -X POST https://www.ideapulley.com/api/v2/deals/42/notes \
  -H "Authorization: Bearer $IDEAPULLEY_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: note-42-1" \
  -d '{"content":"Met the founder. Strong on distribution."}'

Endpoints

FundGet the fund · Get usage · List membersDealsList deals · Create a deal · Get a deal · List the ranked queue · List companies · Get the founder brief · Get thesis fitMemosList memo versions · Get a memo versionNotesList notes · Add a noteDecisions and outcomesList decisions · Record a decision · List decision reasons · List outcomes · Record an outcomeContacts and reportsList contacts · List LP reports · Get an LP reportEvaluationsList evaluations · Start an evaluation · Get an evaluation · Change an evaluation · Find an evaluation · List alertsWebhooksList webhooks · Add a webhook · Get a webhook · Delete a webhook · Send a test event · List deliveriesMore endpointslistSavedSearches · getSavedSearchNetNew · runFolio · getResearch