Introduction
Overview
Access your organisation's data programmatically with the Plinth API.
Looking for US foundation or grants data? That's a different API
This site documents the Plinth platform API, which returns your own organisation's records — members, events, bookings, and your own grant programme. It never returns data about other organisations.
Plinth's public Grants Data API is a separate product at data.useplinth.com: ~205,000 US grantmaking foundations and 17.9 million grants from IRS Form 990 filings, and a free alternative to Candid's Grants, Essentials and Premier APIs. Different domain, different keys, no Plinth account needed.
Getting Started
Learn how to authenticate and make your first API request.
Members
Retrieve and create member records for your organisation.
Events
List events, sessions, and activities.
Bookings
Access event booking and attendance data.
What is Plinth?
Plinth is a community impact platform for managing your community programmes, activities and spaces. It handles client management, case management, bookings, data analysis and reporting.
You can read more about it at plinth.org.uk.
The two Plinth APIs
Plinth publishes two APIs that are often mistaken for each other. They run on different domains, use different keys, and return entirely different things.
| Plinth platform API | Grants Data API | |
|---|---|---|
| Documented at | This site | data.useplinth.com/developers (summary) |
| Returns | Your organisation's own records in Plinth | Public US philanthropy data from IRS Form 990 filings |
| Base URL | https://app.plinth.org.uk/api/v1 | https://data.useplinth.com/api |
| Key format | sk_…, from your Plinth dashboard | plinth_sk_…, free and self-serve |
| Needs a Plinth account? | Yes | No |
| Comparable to | — | Candid's Grants, Essentials and Premier APIs |
The Funds, Grant Applications and Disbursements endpoints below are for running your own grant programme. For data on what other US foundations fund, see the Grants Data API.
Available Endpoints (your organisation's data only)
Every endpoint below is scoped to your own organisation. None of them return records belonging to other organisations, and none of them return US foundation or IRS filing data — that is the separate Grants Data API.
People
| Endpoint | Description |
|---|---|
| Members | Retrieve, filter, and create member records |
| Volunteers | Access volunteer information |
| Partners | View partner organisation records |
Events & Bookings
| Endpoint | Description |
|---|---|
| Events | List events, sessions, and activities |
| Bookings | Access event bookings and attendance |
Forms & Surveys
| Endpoint | Description |
|---|---|
| Forms | List forms and retrieve question details |
| Survey Responses | Access survey and form submissions |
Case Management
| Endpoint | Description |
|---|---|
| Case Notes | Retrieve case notes and records |
Grants & Funding
| Endpoint | Description |
|---|---|
| Funds | View funding programmes |
| Grant Applications | Access grant applications and status |
| Disbursements | View payment disbursements |
Reference
| Endpoint | Description |
|---|---|
| Schemas | Discover available fields for your organisation |
Authentication
All API requests require authentication using an API key. Pass your key in the x-api-key header:
curl -X GET "https://app.plinth.org.uk/api/v1/members" \
-H "x-api-key: sk_your_api_key"
See Getting Started for details on generating and managing API keys.
Base URL
All API requests should be made to:
https://app.plinth.org.uk/api/v1
Response Format
All endpoints return JSON responses with consistent formatting. List endpoints include pagination:
{
"members": [...],
"offset": 0,
"limit": 100,
"total": 250
}
Need Help?
If you have questions about the API or need assistance, please contact your system administrator or reach out to the Plinth support team.