---
title: "InKindDonation (Giving)"
description: "An InKindDonation record represents a non-cash gift given to an Organization at a specific time."
---

> 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.

# InKindDonation (Giving)

An `InKindDonation` record represents a non-cash gift given to an `Organization` at a specific time.

These include items like furniture, vehicles, services, or stocks. `InKindDonations` do not trigger
acknowledgment letter emails via the API — these must be sent from the Giving Admin UI.

[More info](https://help.planningcenter.com/en/138390-in-kind-donations.html)

| Property | Value |
| --- | --- |
| Product | [Giving](/reference/giving/) (`pco.giving`, API version `2019-10-18`) |
| Resource type | `InKindDonation` |
| TypeScript | `Giving.InKindDonation`, attributes `Giving.InKindDonationAttributes`, schema `Giving.InKindDonationSchema` |
| Planning Center path | `/giving/v2/in_kind_donations` |
| Planning Center docs | [InKindDonation](https://api.planningcenteronline.com/docs/apps/giving/versions/2019-10-18/vertices/in_kind_donation) |

## How to reach it

| Client path | Returns | Filters | Create |
| --- | --- | --- | --- |
| `pco.giving.in_kind_donations` | Collection |  | Yes |
| `pco.giving.people.id(personId).in_kind_donations` | Collection |  | No |

From a collection, `.id(inKindDonationId)` addresses one InKindDonation: `pco.giving.in_kind_donations.id(inKindDonationId)`. Collections support [`where`, `include`, `order`, and pagination](/guides/querying/); single resources have `get()`.

## Attributes

On `Giving.InKindDonationAttributes`. Every resource also has `id` and `type` (`'InKindDonation'`) next to its attributes.

| Name | Type | Description |
| --- | --- | --- |
| `acknowledgment_last_sent_at` | `string \| null` | The timestamp of when the acknowledgment letter was last sent for this in-kind donation. This value is set automatically and cannot be manually changed. |
| `created_at` | `string \| null` | See [details](#created-at). |
| `description` | `string \| null` | See [details](#description). |
| `exchange_details` | `string \| null` | See [details](#exchange-details). |
| `fair_market_value_cents` | `number \| null` | Optional. The fair market value of an in-kind donation in cents. Must be greater than $0 and less than or equal to $21,000,000. |
| `fair_market_value_currency` | `string \| null` |  |
| `received_on` | `string \| null` | See [details](#received-on). |
| `updated_at` | `string \| null` | See [details](#updated-at). |
| `valuation_details` | `string \| null` | Optional. The fair market for an in-kind donation which should be determined by donors and appraisers. Maximum 255 characters. Example: `Appraised by Bob Johnson CPA (123 Easy Street, Carlsbad CA 92008)` |

### Attribute details

#### `created_at` {#created-at}

The date and time at which an in-kind donation was created.

Example: `2000-01-01T12:00:00Z`

#### `description` {#description}

Required. Brief description of an in-kind donation gift.

Example: `2019 Toyota Corolla (used)`

#### `exchange_details` {#exchange-details}

Optional. Records whether any goods or services were exchanged for an in-kind donation.

Example: `In exchange, a charity event ticket for $100 was provided.`

#### `received_on` {#received-on}

Required. The date an in-kind donation was received.

Format: `YYYY-MM-DD` (e.g. `2025-04-09`).

#### `updated_at` {#updated-at}

The date and time at which an in-kind donation was last updated.

Example: `2000-01-01T12:00:00Z`

## Relationships and includes

Side-load with `include()` (or `get({ include })`) and read with `related(resource, name)`: `campus`, `fund`, `person`.

| Relationship | Type | To | Includable |
| --- | --- | --- | --- |
| `campus` | To one | [Campus](/reference/giving/campus/) | Yes |
| `fund` | To one | [Fund](/reference/giving/fund/) | Yes |
| `person` | To one | [Person](/reference/giving/person/) | Yes |

## Querying

### Where

`where(field, value)` for equality; `where(field, op, value)` with the operators listed.

| Field | Value type | Operators |
| --- | --- | --- |
| `campus_id` | `string \| number` | Equality only |
| `created_at` | `string \| Date` | `gt`, `gte`, `lt`, `lte` |
| `fund_id` | `string \| number` | Equality only |
| `received_on` | `string \| Date` | `gt`, `gte`, `lt`, `lte` |
| `updated_at` | `string \| Date` | `gt`, `gte`, `lt`, `lte` |

### Order

`order(...)` accepts these fields, ascending, or descending with a `-` prefix: `created_at`, `received_on`, `updated_at`.

## Edges

Follow these from one InKindDonation, `ref = pco.giving.in_kind_donations.id(inKindDonationId)`:

| Edge | Leads to | Returns | Filters | Create |
| --- | --- | --- | --- | --- |
| `ref.campus` | [Campus](/reference/giving/campus/) | Collection |  | No |
| `ref.fund` | [Fund](/reference/giving/fund/) | Collection |  | No |
| `ref.person` | [Person](/reference/giving/person/) | Collection |  | No |

## Writing

| Property | Value |
| --- | --- |
| Create | Yes, `create()` on `pco.giving.in_kind_donations` |
| Update | Yes, `update()` on a reference |
| Delete | Yes, `delete()` on a reference |

### Create attributes

Typed as `Giving.InKindDonationSchema['create']`.

| Attribute | Type |
| --- | --- |
| `campus_id` | `string` |
| `description` | `string \| null` |
| `exchange_details` | `string \| null` |
| `fair_market_value_cents` | `number \| null` |
| `fair_market_value_currency` | `string \| null` |
| `fund_id` | `string` |
| `internal_notes` | `unknown` |
| `person_id` | `string` |
| `received_on` | `string \| null` |
| `valuation_details` | `string \| null` |

### Update attributes

Typed as `Giving.InKindDonationSchema['update']`.

| Attribute | Type |
| --- | --- |
| `campus_id` | `string` |
| `description` | `string \| null` |
| `exchange_details` | `string \| null` |
| `fair_market_value_cents` | `number \| null` |
| `fair_market_value_currency` | `string \| null` |
| `fund_id` | `string` |
| `internal_notes` | `unknown` |
| `person_id` | `string` |
| `received_on` | `string \| null` |
| `valuation_details` | `string \| null` |

See [Writing data](/guides/writing-data/).

## Example

```ts
import type { Giving } from '@mackenly/planningcenterkit';

const page = await pco.giving.in_kind_donations.order('created_at').perPage(25).list();
const items: Giving.InKindDonation[] = page.data;
```

Source: https://planningcenterkit.mackenly.com/reference/giving/in-kind-donation/index.mdx
