IdeaPulleyDocs
GuidesAPI referenceOpenAPI
Open app
  • Introduction
Get started
  • Authentication
  • API basics
  • Errors
  • Rate limits
Endpoints
  • Fund
  • Deals
    • List dealsGET
    • Create a dealPOST
    • Get a dealGET
    • List the ranked queueGET
    • List companiesGET
    • Get the founder briefGET
    • Get thesis fitGET
  • 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
Deals

Deals

Deal endpoints read and add the companies in your fund, with their scores, findings, risks and founder briefs. Use them to sync deals into your CRM or data warehouse.

List deals

Deals the key's creator can see, newest first. Each has `signals` (as on GET /deals/{id}).

GEThttps://www.ideapulley.com/api/v2/dealsdeals: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/deals \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/deals", {
  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/deals",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

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

Create a deal

Add a company to the fund (deduplicated) and start scoring it.

POSThttps://www.ideapulley.com/api/v2/dealsdeals: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
companyNameRequired

The company name. Up to 200 characters.

string
website

The company website. Up to 500 characters.

string
description

What the company does. Up to 20,000 characters.

string
founderName

The founder name. Up to 200 characters.

string
founderEmail

The founder email. Up to 320 characters.

string
sector

The sector, such as fintech. Up to 100 characters.

string
stage

The round stage, such as seed. Up to 100 characters.

string
evaluate

Start scoring the company at once. Default true.

boolean

Example request

cURL
curl -X POST https://www.ideapulley.com/api/v2/deals \
  -H "Authorization: Bearer $IDEAPULLEY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"companyName":"Acme Robotics","website":"https://acme.example","description":"Acme builds robots that pick orders in small warehouses.","founderName":"Ada Lee","founderEmail":"ada@acme.example","sector":"robotics","stage":"seed","evaluate":true}'
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/deals", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "companyName": "Acme Robotics",
    "website": "https://acme.example",
    "description": "Acme builds robots that pick orders in small warehouses.",
    "founderName": "Ada Lee",
    "founderEmail": "ada@acme.example",
    "sector": "robotics",
    "stage": "seed",
    "evaluate": true
  }),
});
const data = await res.json();
Python
import os
import requests

res = requests.post(
    "https://www.ideapulley.com/api/v2/deals",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
    json={
        "companyName": "Acme Robotics",
        "website": "https://acme.example",
        "description": "Acme builds robots that pick orders in small warehouses.",
        "founderName": "Ada Lee",
        "founderEmail": "ada@acme.example",
        "sector": "robotics",
        "stage": "seed",
        "evaluate": True
    },
)
data = res.json()

Response

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

Get a deal

One deal with its score, findings and risks, and `signals`: the reason, the Arlo line and the VC signals (positive signal, one line, fit misses, hygiene, heat, dontMiss, scoreParts, marketScore).

GEThttps://www.ideapulley.com/api/v2/deals/{id}deals:read

Path parameters

NameType
idRequired

The ID.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/deals/42 \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/deals/42", {
  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/deals/42",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

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

List the ranked queue

The ranked deal queue, best first (up to 100): score, reason, flags and the VC signals. lane=dont_miss lists only deals with a strong founder and a low market score, in the same order.

GEThttps://www.ideapulley.com/api/v2/queuedeals: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
lane

all: the whole queue. dont_miss: strong founder, low market score. One of "all", "dont_miss". Default "all".

enum

Example request

cURL
curl https://www.ideapulley.com/api/v2/queue \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/queue", {
  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/queue",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

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

List companies

Companies in the fund (one per deal): name, website, sector, stage.

GEThttps://www.ideapulley.com/api/v2/companiesdeals: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/companies \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/companies", {
  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/companies",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

200 · application/json
{
  "data": [
    {
      "id": 42,
      "companyName": "Acme Robotics",
      "website": "https://acme.example",
      "sector": "robotics",
      "stage": "seed",
      "createdAt": 1793577600,
      "updatedAt": 1793664000
    }
  ],
  "next_cursor": "eyJpZCI6NDJ9",
  "has_more": true
}

Get the founder brief

The latest founder brief for a deal; partial sections while status is running.

GEThttps://www.ideapulley.com/api/v2/deals/{id}/founder-briefdeals:read

Path parameters

NameType
idRequired

The ID.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/deals/42/founder-brief \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/deals/42/founder-brief", {
  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/deals/42/founder-brief",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

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

Get thesis fit

How a deal fits the fund's thesis rules.

GEThttps://www.ideapulley.com/api/v2/deals/{id}/thesisdeals:read

Path parameters

NameType
idRequired

The ID.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/deals/42/thesis \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/deals/42/thesis", {
  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/deals/42/thesis",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

200 · application/json
{
  "data": { … }
}
IdeaPulleyDocs
GuidesAPI referenceOpenAPI
Open app
  • Introduction
Get started
  • Authentication
  • API basics
  • Errors
  • Rate limits
Endpoints
  • Fund
  • Deals
    • List dealsGET
    • Create a dealPOST
    • Get a dealGET
    • List the ranked queueGET
    • List companiesGET
    • Get the founder briefGET
    • Get thesis fitGET
  • 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
Deals

Deals

Deal endpoints read and add the companies in your fund, with their scores, findings, risks and founder briefs. Use them to sync deals into your CRM or data warehouse.

List deals

Deals the key's creator can see, newest first. Each has `signals` (as on GET /deals/{id}).

GEThttps://www.ideapulley.com/api/v2/dealsdeals: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/deals \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/deals", {
  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/deals",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

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

Create a deal

Add a company to the fund (deduplicated) and start scoring it.

POSThttps://www.ideapulley.com/api/v2/dealsdeals: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
companyNameRequired

The company name. Up to 200 characters.

string
website

The company website. Up to 500 characters.

string
description

What the company does. Up to 20,000 characters.

string
founderName

The founder name. Up to 200 characters.

string
founderEmail

The founder email. Up to 320 characters.

string
sector

The sector, such as fintech. Up to 100 characters.

string
stage

The round stage, such as seed. Up to 100 characters.

string
evaluate

Start scoring the company at once. Default true.

boolean

Example request

cURL
curl -X POST https://www.ideapulley.com/api/v2/deals \
  -H "Authorization: Bearer $IDEAPULLEY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"companyName":"Acme Robotics","website":"https://acme.example","description":"Acme builds robots that pick orders in small warehouses.","founderName":"Ada Lee","founderEmail":"ada@acme.example","sector":"robotics","stage":"seed","evaluate":true}'
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/deals", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "companyName": "Acme Robotics",
    "website": "https://acme.example",
    "description": "Acme builds robots that pick orders in small warehouses.",
    "founderName": "Ada Lee",
    "founderEmail": "ada@acme.example",
    "sector": "robotics",
    "stage": "seed",
    "evaluate": true
  }),
});
const data = await res.json();
Python
import os
import requests

res = requests.post(
    "https://www.ideapulley.com/api/v2/deals",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
    json={
        "companyName": "Acme Robotics",
        "website": "https://acme.example",
        "description": "Acme builds robots that pick orders in small warehouses.",
        "founderName": "Ada Lee",
        "founderEmail": "ada@acme.example",
        "sector": "robotics",
        "stage": "seed",
        "evaluate": True
    },
)
data = res.json()

Response

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

Get a deal

One deal with its score, findings and risks, and `signals`: the reason, the Arlo line and the VC signals (positive signal, one line, fit misses, hygiene, heat, dontMiss, scoreParts, marketScore).

GEThttps://www.ideapulley.com/api/v2/deals/{id}deals:read

Path parameters

NameType
idRequired

The ID.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/deals/42 \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/deals/42", {
  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/deals/42",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

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

List the ranked queue

The ranked deal queue, best first (up to 100): score, reason, flags and the VC signals. lane=dont_miss lists only deals with a strong founder and a low market score, in the same order.

GEThttps://www.ideapulley.com/api/v2/queuedeals: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
lane

all: the whole queue. dont_miss: strong founder, low market score. One of "all", "dont_miss". Default "all".

enum

Example request

cURL
curl https://www.ideapulley.com/api/v2/queue \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/queue", {
  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/queue",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

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

List companies

Companies in the fund (one per deal): name, website, sector, stage.

GEThttps://www.ideapulley.com/api/v2/companiesdeals: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/companies \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/companies", {
  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/companies",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

200 · application/json
{
  "data": [
    {
      "id": 42,
      "companyName": "Acme Robotics",
      "website": "https://acme.example",
      "sector": "robotics",
      "stage": "seed",
      "createdAt": 1793577600,
      "updatedAt": 1793664000
    }
  ],
  "next_cursor": "eyJpZCI6NDJ9",
  "has_more": true
}

Get the founder brief

The latest founder brief for a deal; partial sections while status is running.

GEThttps://www.ideapulley.com/api/v2/deals/{id}/founder-briefdeals:read

Path parameters

NameType
idRequired

The ID.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/deals/42/founder-brief \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/deals/42/founder-brief", {
  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/deals/42/founder-brief",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

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

Get thesis fit

How a deal fits the fund's thesis rules.

GEThttps://www.ideapulley.com/api/v2/deals/{id}/thesisdeals:read

Path parameters

NameType
idRequired

The ID.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/deals/42/thesis \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/deals/42/thesis", {
  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/deals/42/thesis",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

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