> ## Documentation Index
> Fetch the complete documentation index at: https://docs.grainledger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Get started with the Grain API for church accounting and donor management.

The Grain API lets you build integrations that read and write church accounting data: transactions, bills, donors, contributions, pledges, and households.

Use the read-only [fund list](https://docs.grainledger.com/giving.md#map-your-giving-funds) to map giving-provider funds to Grain fund IDs.

> [!NOTE]
>
> MCP access is included on Growth and Scale. Organization API keys and unmanaged OAuth require an active Scale subscription. Grain-managed Live OAuth apps with an active grant may call `/api/v1` on Starter and Growth.

## What you can build

> [card] [Accounting sync](https://docs.grainledger.com/api-reference/transactions/list-transactions.md)
>
> Sync bank transactions and vendor bills into your workflows.

> [card] [Giving data](https://docs.grainledger.com/api-reference/contributions/list-contributions.md)
>
> Read contributions, pledges, and donor records for reporting or ChMS bridges.

> [card] [Households](https://docs.grainledger.com/api-reference/households/list-households.md)
>
> Manage household groupings and primary contacts.

> [card] [OAuth apps](https://docs.grainledger.com/authentication.md)
>
> Authenticate users with Sign in with Grain (OAuth 2.1 + PKCE).

## Base URL

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
https://api.grainledger.com
```

For local development, use your server URL (for example `http://localhost:3000`).

## Prerequisites

Use an organization API key for church-owned server automation, or an OAuth 2.1 access token for an application acting on behalf of a user. OAuth requests also need `X-Organization-Id`; API keys infer their organization.

Start with the [API key quickstart](https://docs.grainledger.com/quickstart.md), then see [Authentication](https://docs.grainledger.com/authentication.md) for OAuth and credential lifecycle details.

## Rate limits

| Scope | Limit |
| - | - |
| Standard | 100 requests per minute per organization |
| Burst | Short bursts above the limit may return `429 Too Many Requests` |

Rate limit headers are included on responses:

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1710000060
```

Contact [Grain Support](https://grainledger.com/support) for higher limits on enterprise integrations.

## Next steps

> [card] [Quickstart](https://docs.grainledger.com/quickstart.md)
>
> Make your first authenticated API call in under 10 minutes.

> [card] [Authentication](https://docs.grainledger.com/authentication.md)
>
> Set up OAuth 2.1 with PKCE and token refresh.

> [card] [API reference](https://docs.grainledger.com/api-reference/donors/list-donors.md)
>
> Browse endpoints grouped by resource.

> [card] [Support](https://grainledger.com/support)
>
> Get help from the Grain team.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.