Developer quickstart

Impact Map indexes what nonprofits actually do — activities, strategies, funders, populations, and relationships, extracted from public materials and IRS 990 filings. The same intelligence layer is available as a REST API and an MCP server.

1 · Get an account and API key

Access is currently invite-only — contact us and we'll provision your account. Once you have one, sign in, go to Account → Developers, and create a key. The full key (im_…) is shown once — store it safely. Keys are rate-limited to 100 requests/minute.

2 · Your first call

List the landscapes (named sets of organizations) available on this deployment:

curl https://ny.northstartoolkit.com/api/v1/landscapes \
  -H "Authorization: Bearer YOUR_API_KEY"

3 · Explore a landscape

Search the activity taxonomy of the default landscape (new-york) — or scope any endpoint explicitly with ?landscape=<slug>:

curl "https://ny.northstartoolkit.com/api/v1/search?q=education&landscape=new-york" \
  -H "Authorization: Bearer YOUR_API_KEY"

Then pull the organizations in a result group (a real id from this deployment):

curl "https://ny.northstartoolkit.com/api/v1/activity-groups/group-7ed3179797a0/orgs?limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

4 · Analyze the field

The /analysis and /research groups compute statistics over 990 filings and extracted observations — distributions, trends, benchmarking, funding structure, similarity, and network reads. Every result carries its denominators and a caveats list:

curl "https://ny.northstartoolkit.com/api/v1/analysis/field-stats?metric=total_revenue&group_by=sector" \
  -H "Authorization: Bearer YOUR_API_KEY"

5 · Save findings to your workspace

The workspace endpoints are read-write — lists, notes, and saved views owned by your account:

curl -X POST https://ny.northstartoolkit.com/api/v1/workspace/lists \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "prospects"}'