Skip to content
IdeaScore

IdeaScore API v1.5

In public beta on Professional, Enterprise and Campus, with stable /api/v1 paths and signed webhooks.

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.

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.

  • Choose only the events an address needs
  • Test events never count as failures
  • Signature checks in Node, Python and PHP in the developer docs

Events

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

If your system is down

  1. 30 s
  2. 2 min
  3. 10 min
  4. 1 h
  5. 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.

  • 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.

Read the developer docsSee 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.

IdeaScore