---
title: "Get a list of donation campaigns."
method: POST
path: "/donationCampaigns"
tags: ["Donations"]
---

# Get a list of donation campaigns.

`POST /donationCampaigns`

Queries the available donation campaigns for a donation based on the donation context (like merchant account, currency, and locale). The response contains active donation campaigns.

## Headers

- `Idempotency-Key` string

## Request body

- DonationCampaignsRequest
  - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes/).
  - `label` string — The label that is assigned to the donation campaign.
  - `locale` string — Locale on the shopper interaction device.
  - `merchantAccount` string, required — Your merchant account identifier.
  - `store` string — Required for Adyen for Platforms integrations if you are a platform model. This is your [reference](https://docs.adyen.com/api-explorer/Management/3/post/merchants/(merchantId)/stores#request-reference) (on [balance platform](https://docs.adyen.com/platforms)) or the [storeReference](https://docs.adyen.com/api-explorer/Account/latest/post/updateAccountHolder#request-accountHolderDetails-storeDetails-storeReference) (in the [classic integration](https://docs.adyen.com/classic-platforms/processing-payments/route-payment-to-store/#route-a-payment-to-a-store)) for the ecommerce or point-of-sale store that is processing the payment.

## Response `200`

OK - the request has succeeded.

- DonationCampaignsResponse
  - `donationCampaigns` DonationCampaign[] — List of active donation campaigns for your merchant account.
    - `amounts` Amounts
      - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes/).
      - `values` integer[], required — The amounts of the donation (in [minor units](https://docs.adyen.com/development-resources/currency-codes/)).
    - `bannerUrl` string — The URL for the banner of the nonprofit or campaign.
    - `campaignName` string — The name of the donation campaign..
    - `causeName` string — The cause of the nonprofit.
    - `donation` Donation
      - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes/).
      - `donationType` string, required — The [type of donation](https://docs.adyen.com/online-payments/donations/#donation-types). Possible values: * **roundup**: a donation where the original transaction amount is rounded up as a donation. * **fixedAmounts**: a donation where you show fixed donations amounts that the shopper can select from.
      - `maxRoundupAmount` integer — The maximum amount a transaction can be rounded up to make a donation. This field is only present when `donationType` is **roundup**.
      - `type` string, required — The [type of donation](https://docs.adyen.com/online-payments/donations/#donation-types). Possible values: * **roundup**: a donation where the original transaction amount is rounded up as a donation. * **fixedAmounts**: a donation where you show fixed donation amounts that the shopper can select from.
      - `values` integer[] — The fixed donation amounts in [minor units](https://docs.adyen.com/development-resources/currency-codes//#minor-units). This field is only present when `donationType` is **fixedAmounts**.
    - `id` string — The unique campaign ID of the donation campaign.
    - `logoUrl` string — The URL for the logo of the nonprofit.
    - `nonprofitDescription` string — The description of the nonprofit.
    - `nonprofitName` string — The name of the nonprofit organization that receives the donation.
    - `nonprofitUrl` string — The website URL of the nonprofit.
    - `termsAndConditionsUrl` string — The URL of the terms and conditions page of the nonprofit and the campaign.

## Other responses

- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

---

[API](https://skmtc.net/adyen/apis/checkoutservice.md) · [All operations](https://skmtc.net/adyen/apis/checkoutservice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/checkoutservice/revisions/a2d1f411288c/schema)