IdeaScore API v1.5

In public beta on Professional, Enterprise and Campus, with stable /api/v1 paths and signed webhooks.In public beta on Professional, Enterprise and Campus. Stable /api/v1 paths, keys with scopes and a test mode, signed webhooks, and Zapier and Make for everything else.

Compare plans

Your first call

GET/api/v1/org

# IDEASCORE_KEY holds a test key, isk_test_...curl "$IDEASCORE_URL/api/v1/org" \  -H "Authorization: Bearer $IDEASCORE_KEY"

Answers with

Your organisation
The key's scopes and mode
Its rate limit

Use a test key: it reaches only your sample data and never sends webhooks. Your base address is in the developer docs.

Public beta: v1.5
Stable paths: /api/v1
Per key, bursts of 120: 60/min
Professional, Enterprise, Campus: 3 plans

Authentication & Keys

Owners create keys in Settings and choose what each is for. Send it as a bearer token.Owners create keys under Settings, Integrations and API, Developers, by choosing what each key is for. Send the key as a bearer token.

Authorization: Bearer isk_live_...

Live keys: Reach your real programmes.; isk_live_
Test keys: Reach only sample data and never send webhooks.; isk_test_
Scopes: Each key does only what it was made for.; Chosen per key
IdeaScore AI: So a script can't use up your credits.; A daily limit per live key
Check it works: Confirms a new key connects.; One button

Limits and safe retries

The numbers, and the safeguards a script needs.

Rate limit
60 / minute
60 requests a minute per key, with bursts of 120. Limits are shared across the whole service.
Safe retries
Idempotency-Key
Send an Idempotency-Key with a request and a retry returns the original answer instead of doing the action twice.
Every answer traced
request id
Every answer carries a request id you can quote to support.

Signed Webhooks You Can Watch

Signed events to your own system, the moment something happens. Webhook Pulse shows the last 60 deliveries.A webhook sends a signed event to your own system the moment something happens. Webhook Pulse in the app draws the last 60 deliveries; send a test event and the answer, such as 200 in 143 ms, lands right there.

Choose only the events an address needs
Test events never count as failures
Signature checks in Node, Python and PHP in the developer docs
Webhooks stop on their own if the key loses access or the receiver says it is gone

Events

A new application arrives
An application is approved, rejected or withdrawn
A round closes
Results are published

If your system is down

30 s
2 min
10 min
1 h
6 h

About seven hours in all. An address that keeps failing is paused, with the reason and Turn back on.

The Developers tab of Integrations and API: the Webhook Pulse chart of deliveries to hooks.meridianpark.org.in, 38 of 38 delivered, with Send a test event and the API keys below. — Every delivery at a glance, and Send a test event to check a webhook in plain words.

Zapier & Make, with No Code

7,000+ apps through Zapier and Make. Paste your tool's address and IdeaScore sends a sample to map.7,000+ apps through Zapier and Make. Pick a goal, choose Zapier or Make, paste the address your tool gives you, and IdeaScore sends a sample marked as a test, so your Zap or scenario has real fields to map.

Zapier uses Webhooks by Zapier, a paid Zapier feature with a free trial
Make uses its custom webhook, free on every Make plan
No API key needed for the guided set-up

Connecting Zapier and Make

Connecting Zapier in IdeaScore, step 2 of 4, Copy the Address From Zapier: three steps to create a Zap with a Catch Hook trigger, the Webhook URL pasted and confirmed as a Zapier address, the name Zapier: new applications to a spreadsheet, and a Create and send a sample button. — Pick a goal, choose Zapier or Make, paste the address from your tool and IdeaScore sends a sample to finish.

Built to Stay Stable

Build once against /api/v1 and expect it to keep working.

Stable paths
Paths under /api/v1 stay stable. New minor numbers only add things.
Notice before change
Anything that could break your code comes only in a new version, with at least 30 days' notice during the beta.
Version history
A breaking change is announced ahead in the version history, public in the app.
Public reference
The reference, with the full OpenAPI description, is open to everyone, with no sign-in needed.
Public beta
IdeaScore API v1.5 is in public beta, with no uptime agreement yet.
Your plan
The API, webhooks, Zapier and Make come with Professional, Enterprise and Campus.

See the integrations

Also Built In

These already cover many integration needs without any code.

Excel exports
Export the submissions table, or a committee report, as an .xlsx file at any point.
Scheduled reports
A funnel, throughput or AI-coverage report emailed to a distribution list on a schedule.
Public results page
A public, read-only results page once a programme's decisions are final.

Ready to Build on IdeaScore?

Read the developer docs, or start a trial and see the product first.

Book a demo Start a 7-day trial