API reference · Charities
List charities
GET/v1/charities
List all our charities.
Requires a Bearer access token.
Parameters
limit#numberin queryintegerminimum 1maximum 100The max number of items to return.
cursor#stringin queryUUIDThe id of the last item from the previous page. Used to fetch the next page.
includeProfile#booleanin queryInclude charity public profile information as displayed in the widgets.
locale#stringin queryCan 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
frenslug#stringin queryFind a charity by its slug. This is useful when you want to find a charity by its slug instead of its charityId.
Response
200 · Charity[]No field is described in the spec.
charityId#stringalways returnedcode#numberalways returnedname#stringalways returnedcauses#Cause[]always returnedslug#stringshortSlug#stringsustainableDevelopmentGoals#SustainableDevelopmentGoal[]always returnedlabels#CharityLabel[]always returnedcreationYear#numberannualBudget#integer (int64)numberOfBeneficiaries#integer (int64)fiscalType#CharityFiscalTypealways returnedPUBLIC_INTERESTHELP_TO_PEOPLE_IN_NEEDHELP_FOR_RELOCATION_OF_DOMESTIC_VIOLENCE_VICTIMStype#CharityTypeCHARITYENDOWMENT_FUNDPUBLIC_INSTITUTIONSCIENTIFIC_COOPERATION_FOUNDATIONPRIVATE_HEALTHCARE_ESTABLISHMENT_OF_COLLECTIVE_INTERESTfiscalReceiptsSupport#CharityFiscalReceiptsSupportalways returnedENABLEDDISABLEDNOT_APPLICABLEprofile#CharityProfileWithInsightsalways returned26 child fields
charityProfileIdstringalways returnedstatusCharityProfileStatusalways returnedDRAFTPUBLISHEDtypeCharityProfileTypealways returnedCOUNTRYINTERNATIONALcountrystringlanguageLanguagealways returnedfrenisAutomaticallyTranslatedbooleanalways returnednamestringalways returnedtaglinestringalways returnedpurposestringalways returneddescriptionstringalways returnedwebsitestringfacebookstringtwitterstringinstagramstringyoutubestringlinkedInstringlinkedInHandlestringannualReportstringlogoUrlstringcoversstring[]always returnedvideoUrlstringcharityIdstringalways returnedcreatedAtstring (date-time)always returnedupdatedAtstring (date-time)always returnedinsightsCharityInsight[]always returned6 child fields
charityInsightIdstringalways returnedvaluestringalways returnedlabelstringalways returnedcharityProfileIdstringalways returnedcreatedAtstring (date-time)always returnedupdatedAtstring (date-time)always returned
impactIndicatorsCharityImpactIndicator[]always returned7 child fields
charityImpactIndicatorIdstringalways returnedbaseAmountinteger (int64)always returnedsingularLabelstringalways returnedpluralLabelstringalways returnedcharityProfileIdstringcreatedAtstring (date-time)always returnedupdatedAtstring (date-time)always returned
Errors
400A field is missing, has the wrong type, or is not part of the request schema.
Every request with a body or query is validated.
{ "statusCode": 400, "message": [ "amount must not be less than 1", "property foo should not exist" ], "error": "Bad Request" }401Unauthorized
Missing, expired or invalid access token.
{ "statusCode": 401, "message": "Unauthorized" }403Account closed
{ "message": "Account closed", "code": "ACCOUNT_CLOSED" }
curl -X GET https://api.sandbox.charitips.com/v1/charities \ -H "Authorization: Bearer $CHARITIPS_TOKEN"Request bodies are written for this docs and checked against the API's validation; ids in angle brackets are placeholders. Response values are placeholders built from the schema.