---
title: "Giving reference"
description: "Planning Center Giving in Planning Center Kit: Donations, funds, batches, pledges, payment sources, and recurring donations."
---

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

# Giving reference

Donations, funds, batches, pledges, payment sources, and recurring donations.

| Property | Value |
| --- | --- |
| Client property | `pco.giving` |
| Subpath import | `import { createGivingClient } from '@mackenly/planningcenterkit/giving'` |
| Types namespace | `Giving` |
| Base path | `/giving/v2` |
| Pinned API version | `2019-10-18` |
| Resource types | 20 |
| Planning Center docs | [Planning Center Giving API](https://api.planningcenteronline.com/docs/apps/giving/versions/2019-10-18) |

Each product client sends `X-PCO-API-Version: 2019-10-18`, the version these types were generated from. Override it with `new PlanningCenter({ auth, versions: { giving: '...' } })`; the types won't follow. See [Products](/guides/products/).

```ts
import { createGivingClient } from '@mackenly/planningcenterkit/giving';

const giving = createGivingClient({ auth: { applicationId: process.env.PCO_APP_ID!, secret: process.env.PCO_SECRET! } });
const { data: root } = await giving.get(); // /giving/v2
```

## Root collections

Properties on `pco.giving`, named after their URL. `pco.giving.get()` fetches the product root (`/giving/v2`), and `pco.giving.edge(name)` follows any root edge by name.

| Client path | Resource | Returns | Filters | Create |
| --- | --- | --- | --- | --- |
| `pco.giving.batch_groups` | [BatchGroup](/reference/giving/batch-group/) | Collection | `committed`, `in_progress` | Yes |
| `pco.giving.batches` | [Batch](/reference/giving/batch/) | Collection | `committed`, `in_progress` | Yes |
| `pco.giving.campuses` | [Campus](/reference/giving/campus/) | Collection |  | No |
| `pco.giving.donations` | [Donation](/reference/giving/donation/) | Collection | `succeeded` | No |
| `pco.giving.donor_summaries` | [DonorSummary](/reference/giving/donor-summary/) | Collection | `has_joint_giver` | No |
| `pco.giving.funds` | [Fund](/reference/giving/fund/) | Collection |  | Yes |
| `pco.giving.in_kind_donations` | [InKindDonation](/reference/giving/in-kind-donation/) | Collection |  | Yes |
| `pco.giving.labels` | [Label](/reference/giving/label/) | Collection |  | Yes |
| `pco.giving.payment_sources` | [PaymentSource](/reference/giving/payment-source/) | Collection |  | Yes |
| `pco.giving.people` | [Person](/reference/giving/person/) | Collection | `has_donated` | No |
| `pco.giving.pledge_campaigns` | [PledgeCampaign](/reference/giving/pledge-campaign/) | Collection |  | Yes |
| `pco.giving.recurring_donations` | [RecurringDonation](/reference/giving/recurring-donation/) | Collection |  | No |

## Resources

| Resource | TypeScript | Description |
| --- | --- | --- |
| [Batch](/reference/giving/batch/) | `Giving.Batch` | A Batch is a collection of Donations. |
| [BatchGroup](/reference/giving/batch-group/) | `Giving.BatchGroup` | A BatchGroup is a collection of Batches. |
| [Campus](/reference/giving/campus/) | `Giving.Campus` | A Campus that has been added to your Organization. |
| [Designation](/reference/giving/designation/) | `Giving.Designation` | A Designation conveys how much of a Donation goes to a particular Fund. |
| [DesignationRefund](/reference/giving/designation-refund/) | `Giving.DesignationRefund` | A record that links a Refund with a Designation |
| [Donation](/reference/giving/donation/) | `Giving.Donation` | A Donation record corresponds to a gift given to an Organization at a particular point in time. |
| [DonorSummary](/reference/giving/donor-summary/) | `Giving.DonorSummary` | A donor and their aggregate giving to an Organization (name, donor number, total received, donation count, and first gift date), summed over a requested date range, defaulting to the last 30 days. |
| [Fund](/reference/giving/fund/) | `Giving.Fund` | A Fund is a way of tracking the intent of Donation. |
| [InKindDonation](/reference/giving/in-kind-donation/) | `Giving.InKindDonation` | An InKindDonation record represents a non-cash gift given to an Organization at a specific time. |
| [Label](/reference/giving/label/) | `Giving.Label` | A Label is a way for Admins to manage and categorize Donations. |
| [Note](/reference/giving/note/) | `Giving.Note` | A Note is a way for Giving Admins and Bookkeepers to communicate internally about a donation. |
| [Organization](/reference/giving/organization/) | `Giving.Organization` | The root level Organization record which serves as a link to Donations, People, Funds, etc. |
| [PaymentMethod](/reference/giving/payment-method/) | `Giving.PaymentMethod` | Stored PaymentMethod information (card or bankaccount) used by donors to make online Donations. |
| [PaymentSource](/reference/giving/payment-source/) | `Giving.PaymentSource` | A donation's PaymentSource refers to the platform it originated from. |
| [Person](/reference/giving/person/) | `Giving.Person` | A Planning Center Person record that has been added to Giving. |
| [Pledge](/reference/giving/pledge/) | `Giving.Pledge` | A Pledge made by a Person toward a particular PledgeCampaign. |
| [PledgeCampaign](/reference/giving/pledge-campaign/) | `Giving.PledgeCampaign` | A PledgeCampaign is a way to request and track long-terms commitments to a particular goal or project. |
| [RecurringDonation](/reference/giving/recurring-donation/) | `Giving.RecurringDonation` | A RecurringDonation is represents a Donation that repeats on a set schedule (weekly, monthly, etc.) Data for RecurringDonations is read-only; they can not be created or edited through the API. |
| [RecurringDonationDesignation](/reference/giving/recurring-donation-designation/) | `Giving.RecurringDonationDesignation` | Much like a Designation, A RecurringDonationDesignation conveys how much of a RecurringDonation goes to a particular Fund. |
| [Refund](/reference/giving/refund/) | `Giving.Refund` | A Refund record holds information pertaining to a refunded Donation. |

Source: https://planningcenterkit.mackenly.com/reference/giving/index.mdx
