The UK Charity Commission API
npm install charity-commission-apiThis is the Unofficial node package for the Charity Commission's API. It uses Promises to wrap asynchronous calls around the API. With this API you can search the comissions data on all charites resgistered in the United Kingdom.
Note: Before you begin will need to register as a developer to receive your API key.
To install locally:
``shell`
npm install charity-commission-api --save
###General Syntax
`shell
const ccAPI = require('charity-commission-api');
const args = { APIKey: 'xx-xx-xx-x', strSearch: '
ccAPI.
console.log(result);
}).catch(function(err) {
console.log(Call to ${err.operationName} failed with error: ${err.err});`
});
##Sample Usage
1. Create a new directory with
2. Enter the directory with . Then initialize it with npm init. You will be prompted to create a package.json file. Accept all the defaults.touch index.js
3. Create an empty js file
4. Install the package with this will save the package version to the package.json filenode index.js
5. Copy the following code into index.js. Enter at the terminal to run; remembering to substitute in your API key.`shell
const ccAPI = require('charity-commission-api');
const args = { APIKey: 'xx-xx-xx-x', strSearch: 'happy' };
ccAPI.GetCharitiesByKeyword(args).then(function(result) {
console.log(result);
}).catch(function(err) {
console.log(Call to ${err.operationName} failed with error: ${err.err});``
});
##API
###Supported Methods
GetCharities - Accepts multiple search criteria variables and returns a list of matching Charities.
GetCharitiesByKeyword - Allows you to search charities by Keyword
GetCharitiesByName - Allows you to search charities by Name
GetCharityAccountListing - Retrieves Account Listing data for a specific charity.
GetCharityAnnualReturns - Retreives Annual Returns data for a specific charity.
GetCharityAreasOfOperation - Retrieves Areas of Operation for a specific charity.
GetCharityByRegisteredCharityNumber - Retrieves specific charity details.
GetCharityByRegisteredCharityNumberAndSubsidiaryNumber - Retrieves specific charity subsidiary details.
GetCharityChartAssetsLiabilitiesAndPeople - Retrieves chart data for charity assets, liabilities and people.
GetCharityChartCharitableSpending - Retrieves chart data for charity charitable spending.
GetCharityChartComplianceHistory - Retrieves chart data for charity compliance history.
GetCharityChartFinancialHistory - Retrieves chart data for charity financial history.
GetCharityChartIncome - Retrieves chart data for charity income.
GetCharityChartIncomeAndSpending - Retrieves chart data for charity income and spending.
GetCharityChartSpending - Retrieves chart data for charity spending.
GetCharityFinancialComplianceTableData - Retrieves charity financial compliance data.
GetCharityLatestFiling - Retrieves charity latest filing information.
GetCharityNumbersChart - Retrieves charity numbers.
GetCharityPublishedReport - Retrieves charity published report.
GetCharityRegistrations - Retrieves registration information for a specific charity.
GetCharitySubmissions - Retrieves submission information for a specific charity.
GetCharitySubsidiaries - Retrieves a list of subsidiaries for a specific charity.
GetCharityTrustees - Retrieves a list of Trustees for a specific charity.
GetTrusteeAndRelatedCharities - Retrieves a list of Trustee related charities.
Follow the Developer Guidlines for more information.
##Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style.
Add unit tests for any new or changed functionality. Lint and test your code.