# 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:
# 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
- Log in to your Fundraiso account
- Navigate to Account > API Keys
- 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.