Donations

Donations Documentation

Donation [LIST]

Request

Endpoint

GET /api/v2/account_lists/27be74b1-f397-4612-bf5b-fac2af152367/donations
Content-Type: application/vnd.api+json

Body

Parameters

Sorts

donation_date

Type Unknown

Description Sort by donation_date date

Required No

Filters

designation_account_id

Type ID string

Description Filter where donation designation_account_id is in the collection; accepts ids separated by comma

Required No

donation_date

Type date

Description Filter where donation_date is within provided date range

Required No

donor_account_id

Type ID string

Description Filter where donation donor_account_id is in the collection; accepts ids separated by comma

Required No

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
200 OK

Body

{
  "data": [
    {
      "id": "46adb828-9ca4-4ab8-b17f-72e19590ea6a",
      "type": "donations",
      "attributes": {
        "amount": "10.0",
        "appeal_amount": "0.0",
        "channel": "MyString",
        "converted_amount": 10.0,
        "converted_appeal_amount": 0.0,
        "converted_currency": "USD",
        "created_at": "2021-11-23T14:38:08Z",
        "currency": "ZAR",
        "donation_date": "2021-11-23",
        "legacy_remote_id": null,
        "memo": "MyText",
        "motivation": "MyString",
        "payment_method": "MyString",
        "payment_type": "MyString",
        "remote_id": "3",
        "tendered_amount": "9.99",
        "tendered_currency": "ZAR",
        "updated_at": "2021-11-23T14:38:08Z",
        "updated_in_db_at": "2021-11-23T14:38:08Z"
      },
      "relationships": {
        "appeal": {
          "data": null
        },
        "contact": {
          "data": {
            "id": "8175a878-c57d-43bd-b097-045758092d40",
            "type": "contacts"
          }
        },
        "designation_account": {
          "data": {
            "id": "e7aea048-8e00-4da3-91a6-f25dc9d51995",
            "type": "designation_accounts"
          }
        },
        "donor_account": {
          "data": {
            "id": "c2fd222a-5ddc-4df9-a18c-777d6314e390",
            "type": "donor_accounts"
          }
        },
        "pledge": {
          "data": null
        }
      }
    },
    {
      "id": "7d565da9-5c09-440f-9aea-9674f9e35cc0",
      "type": "donations",
      "attributes": {
        "amount": "10.0",
        "appeal_amount": "0.0",
        "channel": "MyString",
        "converted_amount": 10.0,
        "converted_appeal_amount": 0.0,
        "converted_currency": "USD",
        "created_at": "2021-11-23T14:38:08Z",
        "currency": "ZAR",
        "donation_date": "2021-11-23",
        "legacy_remote_id": null,
        "memo": "MyText",
        "motivation": "MyString",
        "payment_method": "MyString",
        "payment_type": "MyString",
        "remote_id": "4",
        "tendered_amount": "9.99",
        "tendered_currency": "ZAR",
        "updated_at": "2021-11-23T14:38:08Z",
        "updated_in_db_at": "2021-11-23T14:38:08Z"
      },
      "relationships": {
        "appeal": {
          "data": null
        },
        "contact": {
          "data": {
            "id": "8175a878-c57d-43bd-b097-045758092d40",
            "type": "contacts"
          }
        },
        "designation_account": {
          "data": {
            "id": "e7aea048-8e00-4da3-91a6-f25dc9d51995",
            "type": "designation_accounts"
          }
        },
        "donor_account": {
          "data": {
            "id": "c2fd222a-5ddc-4df9-a18c-777d6314e390",
            "type": "donor_accounts"
          }
        },
        "pledge": {
          "data": null
        }
      }
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_count": 2,
      "total_pages": 1
    },
    "sort": null,
    "filter": {
    },
    "totals": [
      {
        "amount": "20.0",
        "converted": 20.0,
        "currency": "ZAR"
      }
    ]
  }
}

Fields

data

Type [Donation]

Description An array of Donations

Donation [POST]

Request

Endpoint

POST /api/v2/account_lists/6fefbaba-3483-47c2-a134-75f494ab313c/donations
Content-Type: application/vnd.api+json

Body

{
  "data": {
    "type": "donations",
    "attributes": {
      "amount": 10.0,
      "appeal_amount": "0.00",
      "channel": "MyString",
      "currency": "ZAR",
      "donation_date": "2021-11-23",
      "memo": "MyText",
      "motivation": "MyString",
      "payment_method": "MyString",
      "payment_type": "MyString",
      "remote_id": "9",
      "tendered_amount": "9.99",
      "tendered_currency": "ZAR",
      "updated_in_db_at": "2021-11-23 14:38:08 UTC"
    },
    "relationships": {
      "donor_account": {
        "data": {
          "type": "donor_accounts",
          "id": "d4724460-12f5-4374-94b0-b0e113468302"
        }
      },
      "designation_account": {
        "data": {
          "type": "designation_accounts",
          "id": "bb49d668-8e53-4550-aa17-7ef96b520ab4"
        }
      }
    }
  }
}

Parameters

Attributes

amount

Type number

Description The original amount

Required No

appeal_amount

Type number

Description The portion of the donation committed to an appeal

Required No

channel

Type string

Description The location where the donation took place

Required No

converted_amount

Type number

Description The amount converted to the receiving organization currency

Required No

converted_appeal_amount

Type number

Description The portion of the converted amount committed to an appeal

Required No

converted_currency

Type string

Description The receiving organization currency

Required No

created_at

Type date

Description The timestamp of when this resource was created

Required No

currency

Type string

Description The currency of the original amount

Required No

donation_date

Type date

Description The date the donation was received

Required No

legacy_remote_id

Type ID string

Description The remote system id given by the legacy orgin system

Required No

memo

Type string

Description Additional notes in relation to this donation

Required No

motivation

Type string

Description The reason why the donor gave the donation

Required No

payment_method

Type string

Description The method the donor used to give their donation

Required No

payment_type

Type string

Description If the donation is recurring in nature

Required No

remote_id

Type ID string

Description The remote system id given by the origin system

Required No

tendered_amount

Type number

Description The actual amount received after applicable fees

Required No

tendered_currency

Type string

Description The currency the donation now resides in

Required No

updated_at

Type date

Description The timestamp of when this resource was last updated

Required No

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

Required No

Relationships

appeal.data

Type Appeal

Description The appeal that the appeal amount contributes to

Required No

contact.data

Type Contact

Description The contact that this donation is connected with within the account list

Required No

designation_account.data

Type Designation Account

Description The designation account the donation belongs to

Required No

donor_account.data

Type Donor Account

Description The donor account the donation belongs to

Required No

pledge.data

Type Pledge

Description The pledge that this appeal amount contributes to

Required No

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
201 Created

Body

{
  "data": {
    "id": "960f0139-1851-488f-9ba0-96890e025df8",
    "type": "donations",
    "attributes": {
      "amount": "10.0",
      "appeal_amount": "0.0",
      "channel": "MyString",
      "converted_amount": 10.0,
      "converted_appeal_amount": 0.0,
      "converted_currency": "USD",
      "created_at": "2021-11-23T14:38:08Z",
      "currency": "ZAR",
      "donation_date": "2021-11-23",
      "legacy_remote_id": null,
      "memo": "MyText",
      "motivation": "MyString",
      "payment_method": "MyString",
      "payment_type": "MyString",
      "remote_id": "9",
      "tendered_amount": "9.99",
      "tendered_currency": "ZAR",
      "updated_at": "2021-11-23T14:38:08Z",
      "updated_in_db_at": "2021-11-23T14:38:08Z"
    },
    "relationships": {
      "appeal": {
        "data": null
      },
      "contact": {
        "data": {
          "id": "752f5004-138a-4aab-a696-3dc2ab06e01c",
          "type": "contacts"
        }
      },
      "designation_account": {
        "data": {
          "id": "bb49d668-8e53-4550-aa17-7ef96b520ab4",
          "type": "designation_accounts"
        }
      },
      "donor_account": {
        "data": {
          "id": "d4724460-12f5-4374-94b0-b0e113468302",
          "type": "donor_accounts"
        }
      },
      "pledge": {
        "data": null
      }
    }
  }
}

Fields

Attributes

amount

Type number

Description The original amount

appeal_amount

Type number

Description The portion of the donation committed to an appeal

channel

Type string

Description The location where the donation took place

converted_amount

Type number

Description The amount converted to the receiving organization currency

converted_appeal_amount

Type number

Description The portion of the converted amount committed to an appeal

converted_currency

Type string

Description The receiving organization currency

created_at

Type date

Description The timestamp of when this resource was created

currency

Type string

Description The currency of the original amount

donation_date

Type date

Description The date the donation was received

legacy_remote_id

Type ID string

Description The remote system id given by the legacy orgin system

memo

Type string

Description Additional notes in relation to this donation

motivation

Type string

Description The reason why the donor gave the donation

payment_method

Type string

Description The method the donor used to give their donation

payment_type

Type string

Description If the donation is recurring in nature

remote_id

Type ID string

Description The remote system id given by the origin system

tendered_amount

Type number

Description The actual amount received after applicable fees

tendered_currency

Type string

Description The currency the donation now resides in

updated_at

Type date

Description The timestamp of when this resource was last updated

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

Relationships

appeal.data

Type Appeal

Description The appeal that the appeal amount contributes to

contact.data

Type Contact

Description The contact that this donation is connected with within the account list

designation_account.data

Type Designation Account

Description The designation account the donation belongs to

donor_account.data

Type Donor Account

Description The donor account the donation belongs to

pledge.data

Type Pledge

Description The pledge that this appeal amount contributes to

Donation [GET]

Request

Endpoint

GET /api/v2/account_lists/fbf558e9-adec-4181-9ee2-b37fc5c793ee/donations/2bdade1c-a2d2-40cd-bdf5-ab7e5ae93b8d
Content-Type: application/vnd.api+json

Body

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
200 OK

Body

{
  "data": {
    "id": "2bdade1c-a2d2-40cd-bdf5-ab7e5ae93b8d",
    "type": "donations",
    "attributes": {
      "amount": "10.0",
      "appeal_amount": "0.0",
      "channel": "MyString",
      "converted_amount": 10.0,
      "converted_appeal_amount": 0.0,
      "converted_currency": "USD",
      "created_at": "2021-11-23T14:38:09Z",
      "currency": "ZAR",
      "donation_date": "2021-11-23",
      "legacy_remote_id": null,
      "memo": "MyText",
      "motivation": "MyString",
      "payment_method": "MyString",
      "payment_type": "MyString",
      "remote_id": "13",
      "tendered_amount": "9.99",
      "tendered_currency": "ZAR",
      "updated_at": "2021-11-23T14:38:09Z",
      "updated_in_db_at": "2021-11-23T14:38:09Z"
    },
    "relationships": {
      "appeal": {
        "data": null
      },
      "contact": {
        "data": {
          "id": "434c79fb-a7f8-48e2-a267-7596b69f442e",
          "type": "contacts"
        }
      },
      "designation_account": {
        "data": {
          "id": "b3d4aa26-2006-4dde-80b2-cb124c5fcc59",
          "type": "designation_accounts"
        }
      },
      "donor_account": {
        "data": {
          "id": "9a65245a-9ebd-4ee5-80a3-d1a906194e80",
          "type": "donor_accounts"
        }
      },
      "pledge": {
        "data": null
      }
    }
  }
}

Fields

Attributes

amount

Type number

Description The original amount

appeal_amount

Type number

Description The portion of the donation committed to an appeal

channel

Type string

Description The location where the donation took place

converted_amount

Type number

Description The amount converted to the receiving organization currency

converted_appeal_amount

Type number

Description The portion of the converted amount committed to an appeal

converted_currency

Type string

Description The receiving organization currency

created_at

Type date

Description The timestamp of when this resource was created

currency

Type string

Description The currency of the original amount

donation_date

Type date

Description The date the donation was received

legacy_remote_id

Type ID string

Description The remote system id given by the legacy orgin system

memo

Type string

Description Additional notes in relation to this donation

motivation

Type string

Description The reason why the donor gave the donation

payment_method

Type string

Description The method the donor used to give their donation

payment_type

Type string

Description If the donation is recurring in nature

remote_id

Type ID string

Description The remote system id given by the origin system

tendered_amount

Type number

Description The actual amount received after applicable fees

tendered_currency

Type string

Description The currency the donation now resides in

updated_at

Type date

Description The timestamp of when this resource was last updated

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

Relationships

appeal.data

Type Appeal

Description The appeal that the appeal amount contributes to

contact.data

Type Contact

Description The contact that this donation is connected with within the account list

designation_account.data

Type Designation Account

Description The designation account the donation belongs to

donor_account.data

Type Donor Account

Description The donor account the donation belongs to

pledge.data

Type Pledge

Description The pledge that this appeal amount contributes to

Donation [PUT]

Request

Endpoint

PUT /api/v2/account_lists/8fcc2595-d745-44eb-af04-8f0a069fd1a6/donations/a8d39522-a28d-4d80-9f08-07d5833f7256
Content-Type: application/vnd.api+json

Body

{
  "data": {
    "type": "donations",
    "attributes": {
      "amount": 10.0,
      "appeal_amount": "0.00",
      "channel": "MyString",
      "currency": "ZAR",
      "donation_date": "2021-11-23",
      "memo": "MyText",
      "motivation": "MyString",
      "payment_method": "MyString",
      "payment_type": "MyString",
      "remote_id": "12",
      "tendered_amount": "9.99",
      "tendered_currency": "ZAR",
      "updated_in_db_at": "2021-11-23 14:38:09 UTC"
    },
    "relationships": {
      "donor_account": {
        "data": {
          "type": "donor_accounts",
          "id": "c5ac5afc-ff75-4ab0-86d3-851a6f20ac7e"
        }
      },
      "designation_account": {
        "data": {
          "type": "designation_accounts",
          "id": "4497ef0a-3360-4699-9416-ab90a4e8b064"
        }
      }
    }
  }
}

Parameters

Attributes

amount

Type number

Description The original amount

Required No

appeal_amount

Type number

Description The portion of the donation committed to an appeal

Required No

channel

Type string

Description The location where the donation took place

Required No

converted_amount

Type number

Description The amount converted to the receiving organization currency

Required No

converted_appeal_amount

Type number

Description The portion of the converted amount committed to an appeal

Required No

converted_currency

Type string

Description The receiving organization currency

Required No

created_at

Type date

Description The timestamp of when this resource was created

Required No

currency

Type string

Description The currency of the original amount

Required No

donation_date

Type date

Description The date the donation was received

Required No

legacy_remote_id

Type ID string

Description The remote system id given by the legacy orgin system

Required No

memo

Type string

Description Additional notes in relation to this donation

Required No

motivation

Type string

Description The reason why the donor gave the donation

Required No

overwrite

Type boolean

Description Only used for updating a record where you want to ignore the server's ' 'updated_in_db_at value and force overwrite the values for the record. ' 'Must be true to work.

Required No

payment_method

Type string

Description The method the donor used to give their donation

Required No

payment_type

Type string

Description If the donation is recurring in nature

Required No

remote_id

Type ID string

Description The remote system id given by the origin system

Required No

tendered_amount

Type number

Description The actual amount received after applicable fees

Required No

tendered_currency

Type string

Description The currency the donation now resides in

Required No

updated_at

Type date

Description The timestamp of when this resource was last updated

Required No

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

Required No

Relationships

appeal.data

Type Appeal

Description The appeal that the appeal amount contributes to

Required No

contact.data

Type Contact

Description The contact that this donation is connected with within the account list

Required No

designation_account.data

Type Designation Account

Description The designation account the donation belongs to

Required No

donor_account.data

Type Donor Account

Description The donor account the donation belongs to

Required No

pledge.data

Type Pledge

Description The pledge that this appeal amount contributes to

Required No

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
200 OK

Body

{
  "data": {
    "id": "a8d39522-a28d-4d80-9f08-07d5833f7256",
    "type": "donations",
    "attributes": {
      "amount": "10.0",
      "appeal_amount": "0.0",
      "channel": "MyString",
      "converted_amount": 10.0,
      "converted_appeal_amount": 0.0,
      "converted_currency": "USD",
      "created_at": "2021-11-23T14:38:09Z",
      "currency": "ZAR",
      "donation_date": "2021-11-23",
      "legacy_remote_id": null,
      "memo": "MyText",
      "motivation": "MyString",
      "payment_method": "MyString",
      "payment_type": "MyString",
      "remote_id": "12",
      "tendered_amount": "9.99",
      "tendered_currency": "ZAR",
      "updated_at": "2021-11-23T14:38:09Z",
      "updated_in_db_at": "2021-11-23T14:38:09Z"
    },
    "relationships": {
      "appeal": {
        "data": null
      },
      "contact": {
        "data": {
          "id": "934f7841-6737-4cf6-b0b9-b08e28d3cfa3",
          "type": "contacts"
        }
      },
      "designation_account": {
        "data": {
          "id": "4497ef0a-3360-4699-9416-ab90a4e8b064",
          "type": "designation_accounts"
        }
      },
      "donor_account": {
        "data": {
          "id": "c5ac5afc-ff75-4ab0-86d3-851a6f20ac7e",
          "type": "donor_accounts"
        }
      },
      "pledge": {
        "data": null
      }
    }
  }
}

Fields

Attributes

amount

Type number

Description The original amount

appeal_amount

Type number

Description The portion of the donation committed to an appeal

channel

Type string

Description The location where the donation took place

converted_amount

Type number

Description The amount converted to the receiving organization currency

converted_appeal_amount

Type number

Description The portion of the converted amount committed to an appeal

converted_currency

Type string

Description The receiving organization currency

created_at

Type date

Description The timestamp of when this resource was created

currency

Type string

Description The currency of the original amount

donation_date

Type date

Description The date the donation was received

legacy_remote_id

Type ID string

Description The remote system id given by the legacy orgin system

memo

Type string

Description Additional notes in relation to this donation

motivation

Type string

Description The reason why the donor gave the donation

payment_method

Type string

Description The method the donor used to give their donation

payment_type

Type string

Description If the donation is recurring in nature

remote_id

Type ID string

Description The remote system id given by the origin system

tendered_amount

Type number

Description The actual amount received after applicable fees

tendered_currency

Type string

Description The currency the donation now resides in

updated_at

Type date

Description The timestamp of when this resource was last updated

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

Relationships

appeal.data

Type Appeal

Description The appeal that the appeal amount contributes to

contact.data

Type Contact

Description The contact that this donation is connected with within the account list

designation_account.data

Type Designation Account

Description The designation account the donation belongs to

donor_account.data

Type Donor Account

Description The donor account the donation belongs to

pledge.data

Type Pledge

Description The pledge that this appeal amount contributes to

Donation [DELETE]

Request

Endpoint

DELETE /api/v2/account_lists/a4199a89-9387-4855-93a6-ea860fa18f72/donations/59277782-15fb-4c69-a2cf-afc65892b71b
Content-Type: application/vnd.api+json

Body

Response

Headers

204 No Content

Body

PreviousDesignation Accounts NextDonor Accounts

Last updated 2 years ago