InKindDonation

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

Example Request

curl https://api.planningcenteronline.com/giving/v2/in_kind_donations

View in API Explorer →

Example Object

{
  "type": "InKindDonation",
  "id": "1",
  "attributes": {
    "acknowledgment_last_sent_at": "2000-01-01T12:00:00Z",
    "created_at": "2000-01-01T12:00:00Z",
    "description": "string",
    "exchange_details": "string",
    "fair_market_value_cents": 1,
    "fair_market_value_currency": "USD",
    "received_on": "2000-01-01",
    "updated_at": "2000-01-01T12:00:00Z",
    "valuation_details": "string"
  },
  "relationships": {
    "fund": {
      "data": {
        "type": "Fund",
        "id": "1"
      }
    },
    "person": {
      "data": {
        "type": "Person",
        "id": "1"
      }
    },
    "campus": {
      "data": {
        "type": "Campus",
        "id": "1"
      }
    }
  }
}

Attributes

Name	Type	Description
`acknowledgment_last_sent_at`	`date_time`	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`	`date_time`	The date and time at which an in-kind donation was created. Example: `2000-01-01T12:00:00Z`
`description`	`string`	Required. Brief description of an in-kind donation gift. Example: `2019 Toyota Corolla (used)`
`exchange_details`	`string`	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.`
`fair_market_value_cents`	`integer`	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`	`currency_abbreviation`
`id`	`primary_key`	The unique identifier for an in-kind donation.
`received_on`	`date`	Required. The date an in-kind donation was received. Format: `YYYY-MM-DD` (e.g. `2025-04-09`).
`updated_at`	`date_time`	The date and time at which an in-kind donation was last updated. Example: `2000-01-01T12:00:00Z`
`valuation_details`	`string`	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)`

Relationships

Name	Type	Association Type	Note
fund	Fund	to_one	`Fund` is required.
person	Person	to_one	`Person` is required.
campus	Campus	to_one	`Campus` is automatically assigned based on the donor's primary campus. If you pass an explicit value (a relationship reference or `null`), it will override the default.

Can Include

Parameter	Value	Description	Assignable
include	campus	include associated campus	create and update
include	fund	include associated fund	create and update
include	person	include associated person	create and update

Order By

Parameter	Value	Type	Description
order	created_at	string	prefix with a hyphen (-created_at) to reverse the order
order	received_on	string	prefix with a hyphen (-received_on) to reverse the order
order	updated_at	string	prefix with a hyphen (-updated_at) to reverse the order

Query By

Name	Parameter	Type	Description	Example
campus_id	`where[campus_id]`	integer	`Campus` is automatically assigned based on the donor's primary campus. If you pass an explicit value (a relationship reference or `null`), it will override the default.	`?where[campus_id]=1`
created_at	`where[created_at]`	date_time	Query on a specific created_at	`?where[created_at]=2000-01-01T12:00:00Z`
fund_id	`where[fund_id]`	integer	`Fund` is required.	`?where[fund_id]=1`
received_on	`where[received_on]`	date	Query on a specific received_on	`?where[received_on]=2000-01-01`
updated_at	`where[updated_at]`	date_time	Query on a specific updated_at	`?where[updated_at]=2000-01-01T12:00:00Z`

Pagination

Name	Parameter	Type	Description
per_page	per_page	integer	how many records to return per page (min=1, max=100, default=25)
offset	offset	integer	get results from given offset

Endpoints

Listing

HTTP Method	Endpoint
GET	`/giving/v2/in_kind_donations`

Reading

HTTP Method	Endpoint
GET	`/giving/v2/in_kind_donations/{id}`

Creating

HTTP Method	Endpoint	Assignable Attributes
POST	`/giving/v2/in_kind_donations`	description exchange_details fair_market_value_cents received_on valuation_details fair_market_value_currency fund_id campus_id person_id

Updating

HTTP Method	Endpoint	Assignable Attributes
PATCH	`/giving/v2/in_kind_donations/{id}`	description exchange_details fair_market_value_cents received_on valuation_details fair_market_value_currency fund_id campus_id person_id

Deleting

HTTP Method	Endpoint
DELETE	`/giving/v2/in_kind_donations/{id}`

Associations

HTTP Method	Endpoint	Returns
GET	`https://api.planningcenteronline.com/giving/v2/in_kind_donations/{in_kind_donation_id}/campus`	Campus
GET	`https://api.planningcenteronline.com/giving/v2/in_kind_donations/{in_kind_donation_id}/fund`	Fund
GET	`https://api.planningcenteronline.com/giving/v2/in_kind_donations/{in_kind_donation_id}/person`	Person

Belongs To

HTTP Method	Endpoint	Association	Details	Filter By
GET	`https://api.planningcenteronline.com/giving/v2/in_kind_donations`	Organization
GET	`https://api.planningcenteronline.com/giving/v2/people/{person_id}/in_kind_donations`	Person