CharityData (Beta)

Using the API

The entire database is available via a RESTFUL API, which will return results in the JSON format. The service works exactly the same way as the HTML service, and you can simply amend the URL from html to json to get a JSON response.

To make a search query, make a get call to /json/search using the parameters below.

To get details of a specifc charity, make a get call to /json/charity/n, where n is the charity registration number.

Please note the following:

  • Parameters fields can be sent in camelCase, but will be automatically turned into lower case
  • The search service will only return a maximum of 250 entries against a query, and a maximum of 50 entries per page. The default is 20.
  • You can not search on email addresses, although these will be returned in the charity details
  • Similarly, you can not currently search on historical annual returns, annual reports or "Part B" information, although these will be returned in the charity details
  • The service only includes active charities, and does not hold information on charities that have been removed from the register.
  • You must include the licence information contained within the boilerplate attribute in both the search results and charity details pages. If you use social media data and/or data about MPs, you must show the respective credit contained in the boilerplate.
  • The service is provided as is; please report any problems with using the service.

For more extensive information on the data, please see the Charity Commission data definition webpage. Guidance on Annual Returns and Annual Accounts is also available.

The parameters

Primary parameters

registrationNumber

subRegistrationNumber

name

formalName

dateOfRegistration

governingDocument

areaOfBusiness

object

contact

address

postcode

phone

companyNumber

website

income

fExpenditure

incomeDate

fystart

fyend

trustees

numOfTrustees

numOfSubCharities

classes

areasOfOperation

localAuthority

countyCouncil

country

constituency

parish

ward

lsoa

metroArea

memberOfParliament

politicalParty

politicalPosition

Geolocation parameters

These parameters are specifically for geolocation searches

gpostcode

glatlng

"Part B" parameters

These parameters will returned additional financial information for charities with an income over £500,000. Currently searches are restricted to data provided in the last financial return; you can not do historical searches.

artype

bfystart

bfyend

incleg

incend

incvol

incfr

incchar

incinvest

incother

inctotal

investgain

assetgain

pensiongain

expvol

exptrade

expinvest

expgrant

expcharble

expgov

expother

exptotal

expsupport

expdep

reserves

assetopen

assetclose

fixedassets

openassets

investassets

cashassets

currentassets

credit1

creditlong

pensionassets

totalassets

fundsend

fundsrestrict

fundsunrestrict

fundstotal

employees

volunteers

consacc

charityacc

Meta parameters

These parameters are affect how the search results are presented, rather than what is searched for. Meta parameters are prefixed with an underscore (eg _view).

_view

_sort

_resultsperpage

_pagenumber

_iscount

_includesubs

Search result fields

These are entries in the search results page that do not directly relate to a query parameter

distance

_totalresults

latLng