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}).
Query parameters
| Name | Type |
|---|---|
limitItems per page (1-200). Default 50. | integer |
cursorThe next_cursor from the previous page. Up to 200 characters. | string |
updated_sinceUnix seconds. Only items created or changed at or after this time. | integer |
Example request
curl https://www.ideapulley.com/api/v2/deals \
-H "Authorization: Bearer $IDEAPULLEY_KEY"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();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
{
"data": [
{ … }
],
"next_cursor": "eyJpZCI6NDJ9",
"has_more": true
}Create a deal
Add a company to the fund (deduplicated) and start scoring it.
Headers
| Name | Type |
|---|---|
Idempotency-KeyOptional. A retry with the same key and body gets the first answer for 24 hours. | string |
Body parameters
| Name | Type |
|---|---|
companyNameRequiredThe company name. Up to 200 characters. | string |
websiteThe company website. Up to 500 characters. | string |
descriptionWhat the company does. Up to 20,000 characters. | string |
founderNameThe founder name. Up to 200 characters. | string |
founderEmailThe founder email. Up to 320 characters. | string |
sectorThe sector, such as fintech. Up to 100 characters. | string |
stageThe round stage, such as seed. Up to 100 characters. | string |
evaluateStart scoring the company at once. Default true. | boolean |
Example request
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}'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();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
{
"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).
Path parameters
| Name | Type |
|---|---|
idRequiredThe ID. | integer |
Example request
curl https://www.ideapulley.com/api/v2/deals/42 \
-H "Authorization: Bearer $IDEAPULLEY_KEY"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();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
{
"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.
Query parameters
| Name | Type |
|---|---|
limitItems per page (1-200). Default 50. | integer |
cursorThe next_cursor from the previous page. Up to 200 characters. | string |
updated_sinceUnix seconds. Only items created or changed at or after this time. | integer |
laneall: the whole queue. dont_miss: strong founder, low market score. One of "all", "dont_miss". Default "all". | enum |
Example request
curl https://www.ideapulley.com/api/v2/queue \
-H "Authorization: Bearer $IDEAPULLEY_KEY"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();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
{
"data": [
{ … }
],
"next_cursor": "eyJpZCI6NDJ9",
"has_more": true
}List companies
Companies in the fund (one per deal): name, website, sector, stage.
Query parameters
| Name | Type |
|---|---|
limitItems per page (1-200). Default 50. | integer |
cursorThe next_cursor from the previous page. Up to 200 characters. | string |
updated_sinceUnix seconds. Only items created or changed at or after this time. | integer |
Example request
curl https://www.ideapulley.com/api/v2/companies \
-H "Authorization: Bearer $IDEAPULLEY_KEY"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();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
{
"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.
Path parameters
| Name | Type |
|---|---|
idRequiredThe ID. | integer |
Example request
curl https://www.ideapulley.com/api/v2/deals/42/founder-brief \
-H "Authorization: Bearer $IDEAPULLEY_KEY"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();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
{
"data": { … }
}Get thesis fit
How a deal fits the fund's thesis rules.
Path parameters
| Name | Type |
|---|---|
idRequiredThe ID. | integer |
Example request
curl https://www.ideapulley.com/api/v2/deals/42/thesis \
-H "Authorization: Bearer $IDEAPULLEY_KEY"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();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
{
"data": { … }
}