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

Decisions and outcomes

Record the fund's Pass, Meet and Invest calls with their reasons, and what happened to each company later. Together they make the fund's track record.

List decisions

Pass / Meet / Invest decisions with their reasons.

GEThttps://www.ideapulley.com/api/v2/decisionsdeals:read

Query parameters

NameType
limit

Items per page (1-200). Default 50.

integer
cursor

The next_cursor from the previous page. Up to 200 characters.

string
updated_since

Unix seconds. Only items created or changed at or after this time.

integer
deal_id

Only decisions on this deal.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/decisions \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/decisions", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
  },
});
const data = await res.json();
Python
import os
import requests

res = requests.get(
    "https://www.ideapulley.com/api/v2/decisions",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

200 · application/json
{
  "data": [
    { … }
  ],
  "next_cursor": "eyJpZCI6NDJ9",
  "has_more": true
}

Record a decision

Record a decision. Needs decisions:write set on the key and a creator who may decide.

POSThttps://www.ideapulley.com/api/v2/decisionsdecisions:write

Headers

NameType
Idempotency-Key

Optional. A retry with the same key and body gets the first answer for 24 hours.

string

Body parameters

NameType
dealIdRequired

The deal ID.

integer
decisionRequired

The call. One of "pass", "meet", "invest".

enum
reasonCode

The main reason, as a code. One of "team", "market_size", "traction", "competition", "valuation", "thesis_fit", "timing", "founder_market_fit", "other", "unspecified".

enum
reason

The reason, in your own words. Up to 4,000 characters.

string

Example request

cURL
curl -X POST https://www.ideapulley.com/api/v2/decisions \
  -H "Authorization: Bearer $IDEAPULLEY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dealId":42,"decision":"pass","reasonCode":"team","reason":"The team is too early for our thesis."}'
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/decisions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "dealId": 42,
    "decision": "pass",
    "reasonCode": "team",
    "reason": "The team is too early for our thesis."
  }),
});
const data = await res.json();
Python
import os
import requests

res = requests.post(
    "https://www.ideapulley.com/api/v2/decisions",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
    json={
        "dealId": 42,
        "decision": "pass",
        "reasonCode": "team",
        "reason": "The team is too early for our thesis."
    },
)
data = res.json()

Response

201 · application/json
{
  "data": { … }
}

List decision reasons

The fixed list of decisions and reason codes.

GEThttps://www.ideapulley.com/api/v2/decisions/reasonsdeals:read

Example request

cURL
curl https://www.ideapulley.com/api/v2/decisions/reasons \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/decisions/reasons", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
  },
});
const data = await res.json();
Python
import os
import requests

res = requests.get(
    "https://www.ideapulley.com/api/v2/decisions/reasons",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

200 · application/json
{
  "data": {
    "decisions": [
      "pass",
      "meet",
      "invest"
    ],
    "reasons": [
      "team",
      "market_size",
      "traction",
      "competition",
      "valuation",
      "thesis_fit",
      "timing",
      "founder_market_fit",
      "other",
      "unspecified"
    ]
  }
}

List outcomes

Resolved calls: what the fund predicted and what happened.

GEThttps://www.ideapulley.com/api/v2/outcomesdeals:read

Query parameters

NameType
limit

Items per page (1-200). Default 50.

integer
cursor

The next_cursor from the previous page. Up to 200 characters.

string
updated_since

Unix seconds. Only items created or changed at or after this time.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/outcomes \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/outcomes", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
  },
});
const data = await res.json();
Python
import os
import requests

res = requests.get(
    "https://www.ideapulley.com/api/v2/outcomes",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

200 · application/json
{
  "data": [
    { … }
  ],
  "next_cursor": "eyJpZCI6NDJ9",
  "has_more": true
}

Record an outcome

Record what happened to a company (raised, failed, acquired...).

POSThttps://www.ideapulley.com/api/v2/outcomesoutcomes:write

Headers

NameType
Idempotency-Key

Optional. A retry with the same key and body gets the first answer for 24 hours.

string

Body parameters

NameType
dealIdRequired

The deal ID.

integer
outcomeRequired

What happened, such as raised, failed or acquired. Up to 50 characters.

string
notes

More detail. Up to 1,000 characters.

string
occurredAt

When it happened, in Unix seconds. Default now.

integer

Example request

cURL
curl -X POST https://www.ideapulley.com/api/v2/outcomes \
  -H "Authorization: Bearer $IDEAPULLEY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dealId":42,"outcome":"raised","notes":"Raised a $4M seed round.","occurredAt":1793577600}'
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/outcomes", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "dealId": 42,
    "outcome": "raised",
    "notes": "Raised a $4M seed round.",
    "occurredAt": 1793577600
  }),
});
const data = await res.json();
Python
import os
import requests

res = requests.post(
    "https://www.ideapulley.com/api/v2/outcomes",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
    json={
        "dealId": 42,
        "outcome": "raised",
        "notes": "Raised a $4M seed round.",
        "occurredAt": 1793577600
    },
)
data = res.json()

Response

201 · application/json
{
  "data": { … }
}
IdeaPulleyDocs
GuidesAPI referenceOpenAPI
Open app
  • Introduction
Get started
  • Authentication
  • API basics
  • Errors
  • Rate limits
Endpoints
  • Fund
  • Deals
  • Memos
  • Notes
  • Decisions and outcomes
    • List decisionsGET
    • Record a decisionPOST
    • List decision reasonsGET
    • List outcomesGET
    • Record an outcomePOST
  • Contacts and reports
  • Evaluations
  • Webhooks
  • More endpoints
Guides
  • Application form
  • Webhook events
  • Claude and ChatGPT (MCP)
  • Zapier, n8n and Polytomic
Decisions and outcomes

Decisions and outcomes

Record the fund's Pass, Meet and Invest calls with their reasons, and what happened to each company later. Together they make the fund's track record.

List decisions

Pass / Meet / Invest decisions with their reasons.

GEThttps://www.ideapulley.com/api/v2/decisionsdeals:read

Query parameters

NameType
limit

Items per page (1-200). Default 50.

integer
cursor

The next_cursor from the previous page. Up to 200 characters.

string
updated_since

Unix seconds. Only items created or changed at or after this time.

integer
deal_id

Only decisions on this deal.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/decisions \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/decisions", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
  },
});
const data = await res.json();
Python
import os
import requests

res = requests.get(
    "https://www.ideapulley.com/api/v2/decisions",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

200 · application/json
{
  "data": [
    { … }
  ],
  "next_cursor": "eyJpZCI6NDJ9",
  "has_more": true
}

Record a decision

Record a decision. Needs decisions:write set on the key and a creator who may decide.

POSThttps://www.ideapulley.com/api/v2/decisionsdecisions:write

Headers

NameType
Idempotency-Key

Optional. A retry with the same key and body gets the first answer for 24 hours.

string

Body parameters

NameType
dealIdRequired

The deal ID.

integer
decisionRequired

The call. One of "pass", "meet", "invest".

enum
reasonCode

The main reason, as a code. One of "team", "market_size", "traction", "competition", "valuation", "thesis_fit", "timing", "founder_market_fit", "other", "unspecified".

enum
reason

The reason, in your own words. Up to 4,000 characters.

string

Example request

cURL
curl -X POST https://www.ideapulley.com/api/v2/decisions \
  -H "Authorization: Bearer $IDEAPULLEY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dealId":42,"decision":"pass","reasonCode":"team","reason":"The team is too early for our thesis."}'
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/decisions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "dealId": 42,
    "decision": "pass",
    "reasonCode": "team",
    "reason": "The team is too early for our thesis."
  }),
});
const data = await res.json();
Python
import os
import requests

res = requests.post(
    "https://www.ideapulley.com/api/v2/decisions",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
    json={
        "dealId": 42,
        "decision": "pass",
        "reasonCode": "team",
        "reason": "The team is too early for our thesis."
    },
)
data = res.json()

Response

201 · application/json
{
  "data": { … }
}

List decision reasons

The fixed list of decisions and reason codes.

GEThttps://www.ideapulley.com/api/v2/decisions/reasonsdeals:read

Example request

cURL
curl https://www.ideapulley.com/api/v2/decisions/reasons \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/decisions/reasons", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
  },
});
const data = await res.json();
Python
import os
import requests

res = requests.get(
    "https://www.ideapulley.com/api/v2/decisions/reasons",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

200 · application/json
{
  "data": {
    "decisions": [
      "pass",
      "meet",
      "invest"
    ],
    "reasons": [
      "team",
      "market_size",
      "traction",
      "competition",
      "valuation",
      "thesis_fit",
      "timing",
      "founder_market_fit",
      "other",
      "unspecified"
    ]
  }
}

List outcomes

Resolved calls: what the fund predicted and what happened.

GEThttps://www.ideapulley.com/api/v2/outcomesdeals:read

Query parameters

NameType
limit

Items per page (1-200). Default 50.

integer
cursor

The next_cursor from the previous page. Up to 200 characters.

string
updated_since

Unix seconds. Only items created or changed at or after this time.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/outcomes \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/outcomes", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
  },
});
const data = await res.json();
Python
import os
import requests

res = requests.get(
    "https://www.ideapulley.com/api/v2/outcomes",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

200 · application/json
{
  "data": [
    { … }
  ],
  "next_cursor": "eyJpZCI6NDJ9",
  "has_more": true
}

Record an outcome

Record what happened to a company (raised, failed, acquired...).

POSThttps://www.ideapulley.com/api/v2/outcomesoutcomes:write

Headers

NameType
Idempotency-Key

Optional. A retry with the same key and body gets the first answer for 24 hours.

string

Body parameters

NameType
dealIdRequired

The deal ID.

integer
outcomeRequired

What happened, such as raised, failed or acquired. Up to 50 characters.

string
notes

More detail. Up to 1,000 characters.

string
occurredAt

When it happened, in Unix seconds. Default now.

integer

Example request

cURL
curl -X POST https://www.ideapulley.com/api/v2/outcomes \
  -H "Authorization: Bearer $IDEAPULLEY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dealId":42,"outcome":"raised","notes":"Raised a $4M seed round.","occurredAt":1793577600}'
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/outcomes", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "dealId": 42,
    "outcome": "raised",
    "notes": "Raised a $4M seed round.",
    "occurredAt": 1793577600
  }),
});
const data = await res.json();
Python
import os
import requests

res = requests.post(
    "https://www.ideapulley.com/api/v2/outcomes",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
    json={
        "dealId": 42,
        "outcome": "raised",
        "notes": "Raised a $4M seed round.",
        "occurredAt": 1793577600
    },
)
data = res.json()

Response

201 · application/json
{
  "data": { … }
}