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/v2The 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
}| Parameter | Meaning |
|---|---|
limit | Items on a page, 1 to 200. Default 50. |
cursor | The next_cursor from the last page. |
updated_since | Unix 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 -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."}'