Skip to main content
The Grain API lets you build integrations that read and write church accounting data: transactions, bills, donors, contributions, pledges, and households.
API access is currently available to select organizations. Request API access to discuss your integration with the Grain team.

​
What you can build

Accounting sync

Sync bank transactions and vendor bills into your workflows.

Giving data

Read contributions, pledges, and donor records for reporting or ChMS bridges.

Households

Manage household groupings and primary contacts.

OAuth apps

Authenticate users with Sign in with Grain (OAuth 2.1 + PKCE).

​
Base URL

https://api.grainledger.com
For local development, use your server URL (for example http://localhost:3000).

​
Prerequisites

Every request needs:
  1. An OAuth 2.1 access token from Sign in with Grain
  2. The X-Organization-Id header for the church whose data you are accessing
See Organizations for how to find an organization ID.

​
Rate limits

ScopeLimit
Standard100 requests per minute per organization
BurstShort bursts above the limit may return 429 Too Many Requests
Rate limit headers are included on responses: 
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1710000060
Contact Grain Support for higher limits on enterprise integrations.

​
Next steps

Quickstart

Make your first authenticated API call in under 10 minutes.

Authentication

Set up OAuth 2.1 with PKCE and token refresh.

API reference

Browse endpoints grouped by resource.

Support

Get help from the Grain team.
Last modified on July 8, 2026