---
title: "Get a list of nonprofits"
method: POST
path: "/companies/{companyId}/nonprofits"
tags: ["Donation campaigns"]
---

# Get a list of nonprofits

`POST /companies/{companyId}/nonprofits`

## Request

- Base URL: `https://management-test.adyen.com/v3`
- URL: `https://management-test.adyen.com/v3/companies/{companyId}/nonprofits`
- Auth: one of:
  - HTTP basic
  - API key in header `X-API-Key`

Returns a list of supported nonprofit organizations to choose from when creating a donation campaign. The list only contains nonprofits that are compatible with all the account holders specified in the request.

## Path parameters

- `companyId` string, required

## Query parameters

- `searchTerm` string
- `pageNumber` integer
- `pageSize` integer
- `goal` string[]

## Request body

- ListNonprofitsRequest
  - `accountHolderIds` string[], required: The unique identifiers of the account holders to be included in a donation campaign.

## Response `200`

OK - the request has succeeded.

- ListNonprofitsResponse
  - `_links` PaginationLinks
    - `first` LinksElement, required
      - `href` string
    - `last` LinksElement, required
      - `href` string
    - `next` LinksElement
      - `href` string
    - `prev` LinksElement
      - `href` string
    - `self` LinksElement, required
      - `href` string
  - `itemsTotal` integer, required: Total number of items.
  - `nonprofits` Nonprofit[]: The supported nonprofit organizations.
    - `causes` NonprofitCause[], required: The causes that the nonprofit supports.
      - `bannerUrl` string, required: The URL to the banner of the cause.
      - `description` string, required: The description of the cause.
      - `id` string: The unique identifier of the cause. This value is generated by Adyen.
      - `locales` string[], required: The locales that the cause supports, in [IETF BCP 47](https://en.wikipedia.org/wiki/IETF_language_tag) format.
      - `name` string, required: The name of the cause.
    - `description` string, required: The description of the nonprofit.
    - `goals` string[], required: The goals of the nonprofit.
    - `id` string: The unique identifier of the nonprofit organization. This value is generated by Adyen.
    - `locales` string[], required: The locales that the nonprofit supports, in [IETF BCP 47](https://en.wikipedia.org/wiki/IETF_language_tag) format.
    - `logoUrl` string, required: The URL to the logo of the nonprofit.
    - `name` string, required: The name of the nonprofit.
    - `regions` string[], required: The regions where the nonprofit operates, in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
    - `termsAndConditionsUrl` string, required: The URL to the terms and conditions of the nonprofit.
    - `website` string, required: The URL to the website of the nonprofit.
  - `pagesTotal` integer, required: Total number of pages.

## 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.
- `503`: Managing donation campaigns is temporarily not possible for this account. The donations themselves are not affected.

## Changes

- **2026-09-23** (v3) `55cb8143ce0e`: 1 info
  - added the non-success response with the status `503`
- **2026-07-13** (v3) `f634b6afa653`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adyen/apis/management-api/changes/companies/:companyId/nonprofits/post.md)

---

[API](https://skmtc.dev/adyen/apis/management-api.md) - [All operations](https://skmtc.dev/adyen/apis/management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adyen/apis/management-api/revisions/55cb8143ce0e?raw)