No key · no account · no charge
Datasets marked open can be read, downloaded, mirrored and built upon without an account, under the listed licences. The API is read-only, allows requests from any website, and carries its sources, licences, dates and coverage limits with the data. Named people and political-finance records keep their separate publication reviews; the public system map does not depend on them.
https://api.taxsorted.io/v1/politics/uk
Release truth: the current corpus has agent and technical screening, not human approval. Production record bodies fail closed until Yu adopts the boundary, reviews the published admission ledger, and a confidential safety-reporting route is live. This page describes the workspace implementation; the public API host may be behind it until an authorised deploy. Once deployed, the catalogue, rights statement and bulk dataset schemas remain readable while bodies are closed.
After this API release is deployed
curl -fsS \
'https://api.taxsorted.io/v1/politics/uk/datasets' \
-o taxsorted-politics-catalogue.jsonThe catalogue distinguishes development-preview, publication-review, approved-disabled, open and emergency-stopped. Only open is an approved hosted release. There is no token or request header to add.
Plain browser JavaScript
const response = await fetch(
"https://api.taxsorted.io/v1/politics/uk/datasets"
);
if (!response.ok) throw new Error(`TaxSorted returned ${response.status}`);
const { publication, datasets } = await response.json();
console.log(publication.status);
console.log(datasets.map(({ id, availability }) => ({ id, availability })));This catalogue example does not assume publication approval. Fetch a record body only when its catalogue entry says availability: open.
Made to travel
Once this API release is deployed, the catalogue remains readable through publication review. Dataset JSON, CSV and NDJSON bodies become downloadable only after the catalogue marks that dataset open.
A self-describing envelope with dataset metadata, records and links. Best for applications and archiving.
One record per row. Arrays and objects are canonical JSON inside one cell, so no values are guessed or flattened away.
One complete JSON record per line. Best for streaming, command-line tools and larger mirrors.
Polite mirroring
The catalogue, and each static dataset representation once open, has an ETag. Send it back as If-None-Match; an unchanged file returns 304 with no body. ETags differ by format, so keep one beside each JSON, CSV or NDJSON mirror.
curl -fsS \
--etag-save taxsorted.etag \
--etag-compare taxsorted.etag \
'https://api.taxsorted.io/v1/politics/uk/datasets' \
-o taxsorted-politics-catalogue.jsonX-Dataset-Version, X-Schema-Version, X-Record-Count and X-Checksum-SHA256 make unattended checks straightforward.
Keep the meaning
sourceIds where present. Source-ledger records carry their own sourceId and official URL.official-sources dataset before redistribution.Reference
GET
The shortest starting response: access terms and links to the catalogue, manifest, sources and OpenAPI document.
GET
/manifestA stable alias of the current open-dataset catalogue for discovery and automated mirroring.
GET
/datasetsEvery distributable dataset, with coverage, record count, versions, fields, licences, source IDs and download URLs.
GET
/datasets/schemaJSON Schema for the shared TaxSorted catalogue and open-dataset envelope.
GET
/datasets/rightsThe machine-readable boundary between TaxSorted's curation licence and source-specific rights.
GET
/datasets/admissionsAfter API deployment: every dataset's purpose, coverage limit, field contract, rights decision, risks, mitigations and pending human decision.
GET
/datasets/enforcement-governanceAfter human release approval: one dataset as a self-describing JSON envelope containing metadata, records and links.
GET
/datasets/enforcement-governance/schemaThe record-level JSON Schema for one dataset. Replace the stable dataset ID to inspect another.
GET
/datasets/enforcement-governance/download?format=csvAfter human release approval: a complete json, csv or ndjson distribution.
GET
/systemAfter human release approval: the mapped non-personal foundation for elections, office power, political funding, public money, relationships, enforcement, history and law watch.
GET
/integrityThe public-integrity scope, evidence rule, dataset doors, excluded material and named-person publication-gate state.
GET
/integrity/sourcesOfficial finance, corporate, land and law-enforcement sources with jurisdiction, reuse and personal-data status.
GET
/integrity/correctionsThe correction, restriction, privacy-objection, urgent-safety and public-tombstone method; public intake is honestly marked not live yet.
GET
/relationships/schemaThe typed evidence-event contract: exact-identifier joins, correction states and no automatic causal inference.
GET
/relationships/datasetsHonest live, mapped, review-gated and licence-gated status for finance and corporate-record sources.
GET
/relationships/contracts?from=2026-06-01&to=2026-06-30&take=10Contracts Finder award releases with organisation identifiers, values and dates; direct contacts, addresses and unsafe supplier names are removed.
GET
/relationships/ministerial-benefits?month=2026-05&department=Home%20Office&type=allReview-gated monthly ministerial gifts and hospitality. Counterparties remain exactly as published and are never name-joined.
GET
/enforcement/institutionsA first UK-wide institutional map of territorial policing, national enforcement, prosecution and principal oversight.
GET
/enforcement/governanceTyped strategy, appointment, accountability, operational-command, inspection, complaint and prosecution relationships.
GET
/enforcement/ranksGeneric rank families by jurisdiction—not a named roster or live incident command chain.
GET
/enforcement/pay-benefitsCurrent England and Wales rank ranges plus official pay, allowance, pension and benefits sources, kept separate and effective-dated.
GET
/enforcement/workforceAggregate workforce and demographic sources with official suppression and no individual characteristics.
GET
/enforcement/fundingOfficial police-funding sources; grants, precepts, capital, reserves, budgets and spending remain distinct measures.
GET
/enforcement/vacanciesOfficial recruitment routes only; TaxSorted never collects applicant data.
GET
/enforcement/activitiesSafe institutional activity coverage such as meetings, minutes, reports and speeches; never deployments, tactics or officer logs.
GET
/enforcement/private-securityThe SIA, private-security company and individual-licence-check boundary; never a bulk worker directory or a claim of police power.
GET
/enforcement/forcesLive institutional force names from data.police.uk, with stated territorial and source gaps.
GET
/enforcement/power/methodThe seven-dimension formal-authority rubric for law-enforcement and accountability offices.
GET
/enforcement/power/officesDraft formal office-power cards with all dimensions and legal constraints visible; no person score or leaderboard.
GET
/enforcement/communication-methodA method-only specification for deterministic surface features in official texts; personality and psychological labels are prohibited.
GET
/elections/processThe UK Parliamentary election chain, responsible actors, public records and stated territorial gaps.
GET
/funding/rulesEffective-dated candidate, party, non-party and regulated-funding rules. This is rules data, not the gated donation register.
GET
/funding/publicPublic democratic-support schemes kept separate from private donations and campaign spending.
GET
/power/methodThe six-dimension, office-not-person scoring method, rubric and comparison limits.
GET
/power/officesProvisional office assessments with evidence, checks and neutral 0–5 dimension scores. No global sort or leaderboard.
GET
/power/offices/uk:office:prime-ministerOne namespaced office assessment and every official source used by its visible dimensions.
GET
/budgets/accountabilityPublic-money responsibility lanes and a status-labelled Main Estimates aggregate snapshot.
GET
/relationships/methodSafe evidence lanes for interests, donations, meetings, lobbying and procurement, including what each record does not prove.
GET
/enforcement/methodRules for keeping allegations, investigations, findings, sanctions, corrections and appeals distinct.
GET
/history/methodThe effective-dated history model, current coverage, privacy boundary and licensed source map.
GET
/law/watchProposed political-system legislation, kept explicitly separate from rules currently in force.
GET
/people?house=commons&q=Abbott&take=20Search every current MP or peer by name, house and party.
GET
/people/5131One sourced record: offices, roles, activity and election result, with staff and registered interests independently gated and not fetched while closed.
GET
/parties?house=commonsActive Parliamentary parties.
GET
/roles?kind=governmentCurrent government or opposition posts and their holders.
GET
/funding/donations?from=2026-01-01&to=2026-03-31&take=20Verified-company party donations only, enabled after both written bulk-reuse confirmation and the separate political-finance privacy review.
GET
/sourcesCoverage, sources, licences and known gaps.
Each dataset names its supporting source IDs; the source ledger resolves them to official URLs.
Small pages, date limits, upstream timeouts and useful cache headers.
Private contacts and donor address fields are removed, not redistributed.
Funding licence gate:the Electoral Commission search and downloads remain the official route today. The normalized donations door returns a clear unavailable response until Political Finance Online's database-reuse and attribution terms are confirmed.
Parliamentary information is attributed under the Open Parliament Licence v3.0; applicable GOV.UK material uses the Open Government Licence v3.0. No licence is assumed for a Political Finance Online mirror. Check the publishing method before republishing joined data.