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.
| Property | Value |
|---|---|
| Product | 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 |
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; 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. |
description |
string | null |
See details. |
exchange_details |
string | null |
See 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. |
updated_at |
string | null |
See details. |
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
The date and time at which an in-kind donation was created.
Example: 2000-01-01T12:00:00Z
description
Required. Brief description of an in-kind donation gift.
Example: 2019 Toyota Corolla (used)
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
Required. The date an in-kind donation was received.
Format: YYYY-MM-DD (e.g. 2025-04-09).
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 | Yes |
fund |
To one | Fund | Yes |
person |
To one | 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 | Collection | No | |
ref.fund |
Fund | Collection | No | |
ref.person |
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.
Example
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;