# Get started

# Base URL

https://api.fundraiso.com/v1/

# API Reference (OpenAPI)

Interactive API Documentation

The full endpoint reference with request/response schemas is available in the Swagger UI:

Open API Documentation

# Requirements

  • A Fundraiso account (any plan)
  • A Personal Access Token created in your account settings

All users can create API tokens to manage their personal lists. To access organisation data (search, details, people, fundings), you also need:

  • A Business plan or higher
  • An active Data Package (e.g. core-org) assigned to your account

Request a data package via the Enterprise pricing form (opens new window).

# Authentication

All Data API requests require a Personal Access Token sent as a Bearer token.

POST /v1/search HTTP/1.1
Host: api.fundraiso.com
Accept: application/json
Authorization: Bearer {your-token}

# Creating a Token

  1. Log in to your Fundraiso account
  2. Navigate to Account > API Keys
  3. Create a new token and copy the value — it is only shown once

# Token Abilities

The scopes available to your token depend on your plan:

Plan Available scopes
Free / Pro list:read, list:write
Business and above All scopes (list, comment, user, flag, inbox — read & write)

When creating a token, you can select specific scopes. If no scopes are selected, your token receives all scopes allowed by your plan.

# Rate Limits

API requests made with a personal access token are subject to daily rate limits based on your plan:

Plan Daily limit
Free 100 requests / day
Pro 1,000 requests / day
Business 10,000 requests / day
Enterprise 10,000 requests / day

When you exceed the limit, the API returns a 429 Too Many Requests response. The limit resets daily.

Rate limit headers

Each response includes X-RateLimit-Limit and X-RateLimit-Remaining headers so you can track your usage programmatically.

# Data Packages

Organisation data access requires an active data package assigned to your account:

Package What you get
core-org Organisation search, contact, address, descriptions
advanced-org Board members, activities, register data
financials Asset sizes, funding records, valuations

Check your active packages:

GET /v1/data-packages

# Quota

Each API request that accesses organisation data consumes 1 quota unit regardless of page size or result count. Monitor your usage via the /v1/data-packages endpoint.

List endpoints (GET /v1/lists, GET /v1/lists/{id}) do not consume quota when no data package enrichment is requested.