Pagination - Grain API

List endpoints return paginated results. Use page and limit query parameters to control how many records you fetch per request.

Query parameters

Parameter	Type	Default	Description
`page`	integer	`1`	Page number (1-based)
`limit`	integer	`20`	Records per page

Use limit=100 or lower for most integrations. Some endpoints allow higher limits; check the API reference for per-endpoint maximums.

Response shape

List endpoints return the resource array plus a pagination object:

{
  "donors": [ ... ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 142,
    "totalPages": 8
  }
}

Field	Description
`page`	Current page number
`limit`	Page size used for this request
`total`	Total matching records
`totalPages`	Total pages at the current limit

Iterate through all pages

async function fetchAllDonors(accessToken, organizationId) {
  const donors = [];
  let page = 1;
  let totalPages = 1;

  while (page <= totalPages) {
    const response = await fetch(
      `https://api.grainledger.com/api/v1/donors?page=${page}&limit=100`,
      {
        headers: {
          Authorization: `Bearer ${accessToken}`,
          "X-Organization-Id": organizationId,
        },
      }
    );
    const data = await response.json();
    donors.push(...data.donors);
    totalPages = data.pagination.totalPages;
    page += 1;
  }

  return donors;
}

import requests

def fetch_all_donors(access_token, organization_id):
    donors = []
    page = 1
    total_pages = 1

    while page <= total_pages:
        response = requests.get(
            "https://api.grainledger.com/api/v1/donors",
            params={"page": page, "limit": 100},
            headers={
                "Authorization": f"Bearer {access_token}",
                "X-Organization-Id": organization_id,
            },
        )
        data = response.json()
        donors.extend(data["donors"])
        total_pages = data["pagination"]["totalPages"]
        page += 1

    return donors

Endpoints that support pagination

All list endpoints use the same pagination pattern:

Last modified on July 8, 2026