Evaluations
Evaluation endpoints start an evaluation, read its score and move it through your pipeline. Use them to send deals in from your CRM, a form or a data warehouse.
List evaluations
The evaluations in your fund, newest first. This list uses page numbers, not cursors.
Query parameters
| Name | Type |
|---|---|
pagePage number. Starts at 1. | integer |
limitRows on a page, 1 to 100. Default 20. | integer |
Example request
curl https://www.ideapulley.com/api/v2/evals \
-H "Authorization: Bearer $IDEAPULLEY_KEY"const res = await fetch("https://www.ideapulley.com/api/v2/evals", {
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/evals",
headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()Response
{
"data": [
{
"id": 42,
"companyName": "Acme Robotics",
"founderName": "Ada Lee",
"overallScore": 7.4,
"recommendation": "pursue",
"status": "complete",
"pipelineStage": "screening",
"sectorTags": [
"robotics"
],
"outcome": null,
"createdAt": 1793577600
}
],
"meta": {
"page": 1,
"limit": 20,
"total": 1
}
}Start an evaluation
Send a company and its application text. The evaluation starts at once and runs in the background. Read it again later to get the score.
Body parameters
| Name | Type |
|---|---|
companyNameRequiredThe company name. | string |
applicationTextRequiredThe application or pitch text. | string |
founderNameThe founder name. | string |
founderEmailThe founder email. | string |
websiteThe company website. | string |
stageThe round stage, such as seed. | string |
sectorTagsSector tags. | string[] |
Example request
curl -X POST https://www.ideapulley.com/api/v2/evals \
-H "Authorization: Bearer $IDEAPULLEY_KEY" \
-H "Content-Type: application/json" \
-d '{"companyName":"Acme Robotics","applicationText":"We build warehouse robots…","founderName":"Ada Lee","stage":"seed"}'const res = await fetch("https://www.ideapulley.com/api/v2/evals", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"companyName": "Acme Robotics",
"applicationText": "We build warehouse robots…",
"founderName": "Ada Lee",
"stage": "seed"
}),
});
const data = await res.json();import os
import requests
res = requests.post(
"https://www.ideapulley.com/api/v2/evals",
headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
json={
"companyName": "Acme Robotics",
"applicationText": "We build warehouse robots…",
"founderName": "Ada Lee",
"stage": "seed"
},
)
data = res.json()Response
{
"data": {
"id": 42,
"companyName": "Acme Robotics",
"founderName": "Ada Lee",
"overallScore": null,
"recommendation": null,
"status": "pending",
"pipelineStage": "inbox",
"sectorTags": [
"robotics"
],
"outcome": null,
"createdAt": 1793577600
}
}Get an evaluation
One evaluation, with its score, recommendation and pipeline stage.
Path parameters
| Name | Type |
|---|---|
idRequiredThe evaluation ID. | integer |
Example request
curl https://www.ideapulley.com/api/v2/evals/42 \
-H "Authorization: Bearer $IDEAPULLEY_KEY"const res = await fetch("https://www.ideapulley.com/api/v2/evals/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/evals/42",
headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()Response
{
"data": {
"id": 42,
"companyName": "Acme Robotics",
"founderName": "Ada Lee",
"overallScore": 7.4,
"recommendation": "pursue",
"status": "complete",
"pipelineStage": "screening",
"sectorTags": [
"robotics"
],
"outcome": null,
"createdAt": 1793577600
}
}Change an evaluation
Change the stage, status, outcome or owner of an evaluation. Send only the fields that you change.
Path parameters
| Name | Type |
|---|---|
idRequiredThe evaluation ID. | integer |
Body parameters
| Name | Type |
|---|---|
pipelineStageThe pipeline stage. | string |
statusThe status. | string |
outcomeThe outcome. | string |
outcomeNotesNotes on the outcome. | string |
assignedToMemberIdThe team member who owns it. | integer |
stageThe round stage. | string |
Example request
curl -X PATCH https://www.ideapulley.com/api/v2/evals/42 \
-H "Authorization: Bearer $IDEAPULLEY_KEY" \
-H "Content-Type: application/json" \
-d '{"pipelineStage":"diligence"}'const res = await fetch("https://www.ideapulley.com/api/v2/evals/42", {
method: "PATCH",
headers: {
Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"pipelineStage": "diligence"
}),
});
const data = await res.json();import os
import requests
res = requests.patch(
"https://www.ideapulley.com/api/v2/evals/42",
headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
json={
"pipelineStage": "diligence"
},
)
data = res.json()Response
{
"data": {
"id": 42,
"companyName": "Acme Robotics",
"founderName": "Ada Lee",
"overallScore": 7.4,
"recommendation": "pursue",
"status": "complete",
"pipelineStage": "diligence",
"sectorTags": [
"robotics"
],
"outcome": null,
"createdAt": 1793577600
}
}Find an evaluation
Find the newest evaluation for a company from a page address (its site, its LinkedIn page or a founder's LinkedIn page) or its name. The browser extension uses this.
Query parameters
| Name | Type |
|---|---|
urlA company site or a LinkedIn page. Send url or name. | string |
nameThe company name. Up to 200 characters. | string |
Example request
curl https://www.ideapulley.com/api/v2/evals/lookup \
-H "Authorization: Bearer $IDEAPULLEY_KEY"const res = await fetch("https://www.ideapulley.com/api/v2/evals/lookup", {
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/evals/lookup",
headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()Response
{
"data": {
"id": 42,
"companyName": "Acme Robotics",
"score": 7.4,
"verdict": "pursue",
"status": "complete",
"chanceOfSuccess": 0.12,
"dealUrl": "https://app.ideapulley.com/…"
}
}List alerts
The alerts that fired in your fund, newest first. Dismissed alerts are not in the list.
Query parameters
| Name | Type |
|---|---|
limitRows to return, 1 to 100. Default 50. | integer |
Example request
curl https://www.ideapulley.com/api/v2/alerts \
-H "Authorization: Bearer $IDEAPULLEY_KEY"const res = await fetch("https://www.ideapulley.com/api/v2/alerts", {
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/alerts",
headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()Response
{
"data": [
{
"id": 9,
"evalId": 42,
"alertType": "kill_criteria",
"message": "Burn is above the fund's limit.",
"triggeredAt": 1793577600
}
]
}