---
title: "List charities"
description: "List all our charities."
canonical: https://www.charitips.com/docs/api-reference/list-charities
---

# List charities

`GET /v1/charities`

List all our charities.

**Authentication**: Bearer access token.

## Parameters

- `limit` (number, integer, minimum 1, maximum 100): The max number of items to return.
- `cursor` (string, UUID): The id of the last item from the previous page. Used to fetch the next page.
- `includeProfile` (boolean): Include charity public profile information as displayed in the widgets.
- `locale` (string): Can only be used with includeProfile=true. Locale to be used for text contents available in the charity public profile such as description, tagline and insights One of `fr`, `en`.
- `slug` (string): Find a charity by its slug. This is useful when you want to find a charity by its slug instead of its charityId.

## Response 200

- `charityId` (string, required)
- `code` (number, required)
- `name` (string, required)
- `causes` (Cause[], required)
- `slug` (string)
- `shortSlug` (string)
- `sustainableDevelopmentGoals` (SustainableDevelopmentGoal[], required)
- `labels` (CharityLabel[], required)
- `creationYear` (number)
- `annualBudget` (integer (int64))
- `numberOfBeneficiaries` (integer (int64))
- `fiscalType` (CharityFiscalType, required) One of `PUBLIC_INTEREST`, `HELP_TO_PEOPLE_IN_NEED`, `HELP_FOR_RELOCATION_OF_DOMESTIC_VIOLENCE_VICTIMS`.
- `type` (CharityType) One of `CHARITY`, `ENDOWMENT_FUND`, `PUBLIC_INSTITUTION`, `SCIENTIFIC_COOPERATION_FOUNDATION`, `PRIVATE_HEALTHCARE_ESTABLISHMENT_OF_COLLECTIVE_INTEREST`.
- `fiscalReceiptsSupport` (CharityFiscalReceiptsSupport, required) One of `ENABLED`, `DISABLED`, `NOT_APPLICABLE`.
- `profile` (CharityProfileWithInsights, required)
  - `charityProfileId` (string, required)
  - `status` (CharityProfileStatus, required) One of `DRAFT`, `PUBLISHED`.
  - `type` (CharityProfileType, required) One of `COUNTRY`, `INTERNATIONAL`.
  - `country` (string)
  - `language` (Language, required) One of `fr`, `en`.
  - `isAutomaticallyTranslated` (boolean, required)
  - `name` (string, required)
  - `tagline` (string, required)
  - `purpose` (string, required)
  - `description` (string, required)
  - `website` (string)
  - `facebook` (string)
  - `twitter` (string)
  - `instagram` (string)
  - `youtube` (string)
  - `linkedIn` (string)
  - `linkedInHandle` (string)
  - `annualReport` (string)
  - `logoUrl` (string)
  - `covers` (string[], required)
  - `videoUrl` (string)
  - `charityId` (string, required)
  - `createdAt` (string (date-time), required)
  - `updatedAt` (string (date-time), required)
  - `insights` (CharityInsight[], required)
    - `charityInsightId` (string, required)
    - `value` (string, required)
    - `label` (string, required)
    - `charityProfileId` (string, required)
    - `createdAt` (string (date-time), required)
    - `updatedAt` (string (date-time), required)
  - `impactIndicators` (CharityImpactIndicator[], required)
    - `charityImpactIndicatorId` (string, required)
    - `baseAmount` (integer (int64), required)
    - `singularLabel` (string, required)
    - `pluralLabel` (string, required)
    - `charityProfileId` (string)
    - `createdAt` (string (date-time), required)
    - `updatedAt` (string (date-time), required)

## Errors

- 400 `A field is missing, has the wrong type, or is not part of the request schema.`: `message` lists every problem. Unknown fields are rejected, not ignored: remove them rather than sending extra data. See https://www.charitips.com/docs/api-reference/errors.md.
- 401 `Unauthorized`: The access token is missing, expired or invalid. Create a new one with your client id and secret, send it as `Authorization: Bearer <accessToken>`, then retry once. Sandbox tokens only work on api.sandbox.charitips.com. See https://www.charitips.com/docs/get-started/authentication.md.
- 403 `Account closed`: The account behind these credentials is closed: no token is issued and every call is refused, reads included. Contact Charitips to reopen it. See https://www.charitips.com/docs/api-reference/troubleshooting.md#calls-answer-403-account-not-active-account-not-validated-or-account-closed.

## Example

```bash
curl -X GET https://api.sandbox.charitips.com/v1/charities \
  -H "Authorization: Bearer $CHARITIPS_TOKEN"
```

```javascript
const response = await fetch('https://api.sandbox.charitips.com/v1/charities', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.CHARITIPS_TOKEN}`,
  },
});
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const data = await response.json();
```

```python
import os, requests

response = requests.get(
    "https://api.sandbox.charitips.com/v1/charities",
    headers={"Authorization": f"Bearer {os.environ['CHARITIPS_TOKEN']}"},
)
response.raise_for_status()
data = response.json()
```

## Response example (200, placeholder values)

```json
[
  {
    "charityId": "<charityId>",
    "code": 1,
    "name": "<name>",
    "causes": [],
    "slug": "<slug>",
    "shortSlug": "<shortSlug>",
    "sustainableDevelopmentGoals": [],
    "labels": []
  }
]
```