IdeaPulleyDocs
GuidesAPI referenceOpenAPI
Open app
  • Introduction
Get started
  • Authentication
  • API basics
  • Errors
  • Rate limits
Endpoints
  • Fund
  • Deals
  • Memos
  • Notes
  • Decisions and outcomes
  • Contacts and reports
  • Evaluations
    • List evaluationsGET
    • Start an evaluationPOST
    • Get an evaluationGET
    • Change an evaluationPATCH
    • Find an evaluationGET
    • List alertsGET
  • Webhooks
  • More endpoints
Guides
  • Application form
  • Webhook events
  • Claude and ChatGPT (MCP)
  • Zapier, n8n and Polytomic
Evaluations

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.

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

Query parameters

NameType
page

Page number. Starts at 1.

integer
limit

Rows on a page, 1 to 100. Default 20.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/evals \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
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();
Python
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

200 · application/json
{
  "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.

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

Body parameters

NameType
companyNameRequired

The company name.

string
applicationTextRequired

The application or pitch text.

string
founderName

The founder name.

string
founderEmail

The founder email.

string
website

The company website.

string
stage

The round stage, such as seed.

string
sectorTags

Sector tags.

string[]

Example request

cURL
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"}'
TypeScript
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();
Python
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

201 · application/json
{
  "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.

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

Path parameters

NameType
idRequired

The evaluation ID.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/evals/42 \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
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();
Python
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

200 · application/json
{
  "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.

PATCHhttps://www.ideapulley.com/api/v2/evals/{id}evals:write

Path parameters

NameType
idRequired

The evaluation ID.

integer

Body parameters

NameType
pipelineStage

The pipeline stage.

string
status

The status.

string
outcome

The outcome.

string
outcomeNotes

Notes on the outcome.

string
assignedToMemberId

The team member who owns it.

integer
stage

The round stage.

string

Example request

cURL
curl -X PATCH https://www.ideapulley.com/api/v2/evals/42 \
  -H "Authorization: Bearer $IDEAPULLEY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pipelineStage":"diligence"}'
TypeScript
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();
Python
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

200 · application/json
{
  "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.

GEThttps://www.ideapulley.com/api/v2/evals/lookupevals:read

Query parameters

NameType
url

A company site or a LinkedIn page. Send url or name.

string
name

The company name. Up to 200 characters.

string

Example request

cURL
curl https://www.ideapulley.com/api/v2/evals/lookup \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
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();
Python
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

200 · application/json
{
  "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.

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

Query parameters

NameType
limit

Rows to return, 1 to 100. Default 50.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/alerts \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
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();
Python
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

200 · application/json
{
  "data": [
    {
      "id": 9,
      "evalId": 42,
      "alertType": "kill_criteria",
      "message": "Burn is above the fund's limit.",
      "triggeredAt": 1793577600
    }
  ]
}
IdeaPulleyDocs
GuidesAPI referenceOpenAPI
Open app
  • Introduction
Get started
  • Authentication
  • API basics
  • Errors
  • Rate limits
Endpoints
  • Fund
  • Deals
  • Memos
  • Notes
  • Decisions and outcomes
  • Contacts and reports
  • Evaluations
    • List evaluationsGET
    • Start an evaluationPOST
    • Get an evaluationGET
    • Change an evaluationPATCH
    • Find an evaluationGET
    • List alertsGET
  • Webhooks
  • More endpoints
Guides
  • Application form
  • Webhook events
  • Claude and ChatGPT (MCP)
  • Zapier, n8n and Polytomic
Evaluations

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.

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

Query parameters

NameType
page

Page number. Starts at 1.

integer
limit

Rows on a page, 1 to 100. Default 20.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/evals \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
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();
Python
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

200 · application/json
{
  "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.

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

Body parameters

NameType
companyNameRequired

The company name.

string
applicationTextRequired

The application or pitch text.

string
founderName

The founder name.

string
founderEmail

The founder email.

string
website

The company website.

string
stage

The round stage, such as seed.

string
sectorTags

Sector tags.

string[]

Example request

cURL
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"}'
TypeScript
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();
Python
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

201 · application/json
{
  "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.

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

Path parameters

NameType
idRequired

The evaluation ID.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/evals/42 \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
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();
Python
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

200 · application/json
{
  "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.

PATCHhttps://www.ideapulley.com/api/v2/evals/{id}evals:write

Path parameters

NameType
idRequired

The evaluation ID.

integer

Body parameters

NameType
pipelineStage

The pipeline stage.

string
status

The status.

string
outcome

The outcome.

string
outcomeNotes

Notes on the outcome.

string
assignedToMemberId

The team member who owns it.

integer
stage

The round stage.

string

Example request

cURL
curl -X PATCH https://www.ideapulley.com/api/v2/evals/42 \
  -H "Authorization: Bearer $IDEAPULLEY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pipelineStage":"diligence"}'
TypeScript
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();
Python
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

200 · application/json
{
  "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.

GEThttps://www.ideapulley.com/api/v2/evals/lookupevals:read

Query parameters

NameType
url

A company site or a LinkedIn page. Send url or name.

string
name

The company name. Up to 200 characters.

string

Example request

cURL
curl https://www.ideapulley.com/api/v2/evals/lookup \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
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();
Python
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

200 · application/json
{
  "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.

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

Query parameters

NameType
limit

Rows to return, 1 to 100. Default 50.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/alerts \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
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();
Python
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

200 · application/json
{
  "data": [
    {
      "id": 9,
      "evalId": 42,
      "alertType": "kill_criteria",
      "message": "Burn is above the fund's limit.",
      "triggeredAt": 1793577600
    }
  ]
}