For AI agents
CharityData publishes analysis of every registered New Zealand charity, built from filings to Charities Services (Ngā Rātonga Kaupapa Atawhai). This page describes how to read that data programmatically, and how we ask you to cite it.
Per-charity endpoints
Every charity profile at https://charitydata.co.nz/charities/{slug} has three machine-readable twins. They are free, need no API key, and are rate limited to 60 requests per 10 minutes per IP. The HTML page advertises them via <link rel="alternate">.
| Endpoint | Content type | Contents |
|---|---|---|
| /api/v1/charities/{slug}/markdown | text/markdown | Full prose summary of one charity — identity, rating, latest annual return, ten-year filing history, governance structure, funders, freshness dates. |
| /api/v1/charities/{slug}/facts.json | application/json | The same facts as structured JSON, with explicit `_nzd` unit suffixes and a discriminated `rating.rated` field. |
| /api/v1/charities/{slug}/summary.md | text/markdown | Short form — roughly 200 words, complete and citable, for when several charities must fit in one context window. |
Worked example: https://charitydata.co.nz/api/v1/charities/{slug}/facts.json. Slugs come from the sitemap below, or from the slug field of any charity search result.
Individuals are not in the machine-readable views
The twins describe governance structurally — board size, whether a chair is recorded, officer and executive counts, remuneration bands — and name no individual. Officer and trustee names are public on the Charities Register and appear on our HTML profile pages, but we do not serve them in a format built for bulk ingestion.
Per-person profiles at /charity-people/{slug} are disallowed to AI crawlers in robots.txt and blocked at the edge. Please do not attempt to assemble person-level profiles from entity pages.
Discovery
https://charitydata.co.nz/llms.txt— what this site is and where the data liveshttps://charitydata.co.nz/sitemap.xml— sharded index of every charity, funder and auditor pagehttps://charitydata.co.nz/robots.txt— what is open and what is not- https://charitydata.co.nz/charity-insights/methodology — how ratings, red flags and scores are computed
Citing this data
Data is available under CC BY 4.0 with attribution to CharityData NZ and to Charities Services as the primary source. Three requests, all of which the endpoints give you the fields to honour:
- Date the fact. Every response carries a
freshnessblock. A rating computed months ago should be cited with the date it was computed, not as today’s position. - Keep a rating attached to its methodology. Grades are an analytical view under a published methodology, not a regulator’s finding. The methodology URL is in every response.
- Do not restate a flag as a finding of wrongdoing. Flags describe metrics falling outside published thresholds for a charity’s size and type. The endpoints return both a machine key and a hedged description — please use the description.
Not rated is a real answer
Most registered charities carry no letter grade. That is deliberate: our engine routes a charity to one of ten statuses, and only rated produces a grade. The rest — limited disclosure, insufficient data, dormant, deregistered and so on — return rating.rated: false with a reason. Please surface the reason rather than treating a missing grade as a low grade.
Corrections
If you or a charity you represent believes something here is wrong, use https://charitydata.co.nz/dispute/new. Corrections are made within 24 hours of being accepted.
Data sourced from Charities Services register and annual returns. Our datasets may not be complete. Automated analysis can produce errors. If you believe any data on this page is incorrect, please contact us at hello@charitydata.co.nz. For informational purposes only. Not investment advice.