API Documentation

REST API access to UK political data - MPs, councils, crime, finance & more.

650

MPs

397

Councils

127k+

Contracts

190k+

Area Metrics

800+

Donors

49k+

Historical Records

Base URL: https://civiccoreinstitute.com

Response Format

All endpoints return JSON with consistent structure. List endpoints include pagination.

// Example: GET /api/mps?limit=2
{
  "mps": [
    { "id": "1", "fullName": "Keir Starmer", "party": "Labour", ... },
    { "id": "2", "fullName": "Rishi Sunak", "party": "Conservative", ... }
  ],
  "pagination": {
    "total": 650,
    "limit": 2,
    "offset": 0,
    "hasMore": true
  }
}

MPs & Parliament

Members of Parliament, interests, expenses, voting records, and comparisons

GET/api/mpsList all MPs with filtering/pagination

GET/api/mps/:idMP details by ID or slug

GET/api/mps/:id/expensesMP expense claims by year

GET/api/mps/:id/claimsIndividual IPSA claims

GET/api/mps/:id/votesVoting record in divisions

GET/api/mps/:id/donorsDonations received

GET/api/mps/:id/incomeRegistered interests and income

GET/api/mps/:id/historical-interests25 years of interests (2000-present)

GET/api/mps/:id/holdingsShareholdings and property

GET/api/mps/:id/conflictsConflict of interest analysis

GET/api/mps/:id/alignmentVoting alignment with other MPs

GET/api/mps/:id/recent-activityRecent votes and interests timeline

GET/api/mps/:id/constituency-councillorsCouncillors in MP's area

GET/api/mps/searchSearch MPs by name

GET/api/mps/compareSide-by-side MP comparison

GET/api/mps/hourly-ratesMPs ranked by employment hourly rate

GET/api/mps/financial-summaryFinancial summary for all MPs

GET/api/mps/expenses/summaryExpense totals across all MPs

GET/api/mps/expenses/party-categoryExpenses by party and category

GET/api/mps/expenses/notableNotable expense claims

GET/api/mps/donations/summaryDonation totals across all MPs

GET/api/mps/voting-summaryVoting participation stats

GET/api/mps/statsAggregate MP statistics

Government

Ministers, special advisers, House of Lords, and mayors

GET/api/ministersList ministers with interests

GET/api/ministers/:idMinister details and interests

GET/api/spadsList special advisers

GET/api/spads/:idSPAD details and interests

GET/api/lordsHouse of Lords members

GET/api/lords/:idLord details and interests

GET/api/mayorsList metro mayors

GET/api/mayors/:idMayor details and interests

Political Parties

Party finances, donations, loans, accounts, and voting patterns

GET/api/partiesList all parties

GET/api/parties/:idParty details

GET/api/parties/:id/donationsParty donations

GET/api/parties/:id/loansParty loans

GET/api/parties/:id/financeFinancial overview

GET/api/parties/:id/accountsAnnual accounts

GET/api/parties/:id/compareCompare with other parties

GET/api/parties/votingParty voting patterns

GET/api/parties/financeAll-party finance comparison

GET/api/parties/donations/timelineDonation timeline

GET/api/loansAll party loans

GET/api/spending/partiesParty spending data

Constituencies

Constituency data, demographics, P&L, polling, and rankings

GET/api/constituenciesList all 650 constituencies

GET/api/constituencies/:idConstituency details

GET/api/constituencies/:id/demographicsPopulation and demographics

GET/api/constituencies/:id/pnlFiscal profit & loss per constituency

GET/api/constituencies/:id/pollingMRP polling data (multi-source)

GET/api/constituencies/rankingsConstituency rankings table

GET/api/pollingNational polling summary with seat projection

GET/api/lookup/postcodeFind MP by postcode

GET/api/boundariesConstituency boundaries

Places & Area Data

Local authority metrics: benefits, demographics, immigration, housing, education, and more

GET/api/places/:id/profilePlace overview profile

GET/api/places/:id/benefitsDWP benefits (UC, HB, PIP, PC)

GET/api/places/:id/demographicsONS population by age band

GET/api/places/:id/immigrationHome Office asylum/UASC data

GET/api/places/:id/justiceMOJ court and justice metrics

GET/api/places/:id/ethnicityCensus 2021 ethnicity breakdown

GET/api/places/:id/housingUK HPI house prices

GET/api/places/:id/educationDfE attainment data (KS4)

GET/api/places/:id/council-taxCouncil tax by band

GET/api/places/:id/religionReligion demographics

GET/api/places/:id/migrationInternal migration data

GET/api/places/:id/school-performanceSchool performance data

GET/api/places/:id/metricsAll PlaceMetric data for an area

GET/api/places/:id/benchmarksArea benchmarks vs national

GET/api/places/:id/timeseriesFiscal time series (2017-2024)

GET/api/areasGeographic areas list

GET/api/areas/:idArea details

Local Councils

UK local authorities, councillors, and election history

GET/api/councilsList all 397 councils

GET/api/councils/:idCouncil details

GET/api/councils/:id/councillorsCouncillors with party breakdown

GET/api/councils/:id/election-historyLocal election results and trends

GET/api/elections/local-trendsNational local election trends

Government Contracts

Contracts Finder OCDS data - 127k+ contracts worth over 1.9 trillion

GET/api/contractsSearch contracts by supplier, buyer, value

GET/api/companies/searchCompany lookup with donation + contract links

Crime & Policing

Crime statistics, police forces, misconduct, and justice system data

GET/api/crime/rankingsConstituency crime league table

GET/api/crime/constituencies/:idCrime data for constituency

GET/api/crime/postcode/:postcodeCrime by postcode

GET/api/crime/trendsCrime trends over time

GET/api/crime/categoriesCrime category breakdown

GET/api/crime/mapMap data for visualisation

GET/api/crime/geojsonCrime GeoJSON for map

GET/api/police/forcesAll 43 police forces

GET/api/police/forces/:codeForce details

GET/api/police/misconductMisconduct statistics by force/year

Courts & Justice

Criminal court statistics, conviction rates, and sentencing data

GET/api/courtsList all courts

GET/api/courts/:slugCourt details

GET/api/courts/nationalNational court statistics and backlog

UK Fiscal Data

National finances, debt, bonds, inflation, employment, and regional data

GET/api/fiscalFiscal overview

GET/api/fiscal/:periodFiscal data by period

GET/api/fiscal/overviewNational fiscal dashboard data

GET/api/fiscal/debtGovernment debt composition

GET/api/fiscal/bondsBond market and gilt data

GET/api/fiscal/inflationCPI/RPI inflation tracker

GET/api/fiscal/employmentEmployment statistics

GET/api/fiscal/foreign-aidForeign aid spending

GET/api/fiscal/regionalRegional financial breakdowns

GET/api/la-financeLA finance overview

GET/api/la-finance/authoritiesList local authorities

GET/api/la-finance/timeseriesLA financial time series

GET/api/places/fiscal-mapFiscal map data

Divisions & Voting

Parliamentary votes, divisions, and bills

GET/api/divisionsList divisions with filtering

GET/api/divisions/:idDivision details with votes

GET/api/billsParliamentary bills

GET/api/electionsGeneral election results

Donors & Donations

Political donors, donation records, and company connections

GET/api/donorsList donors with filtering

GET/api/donors/:idDonor details and donation history

GET/api/searchSearch across donations and donors

Analysis & Projections

Pre-computed analysis, political projections, and cross-cutting insights

GET/api/analysis/projectionsPolitical projection engine (regression + swing)

GET/api/analysis/correlationsConstituency metric correlations

GET/api/analysis/cross-metricsCross-metric scatter analysis

GET/api/analysis/power-structureUK governance hierarchy

GET/api/analysis/financial-interestsInterest patterns

GET/api/analysis/historical-trends25-year interest trends

GET/api/analysis/parliamentary-dynamicsParliament composition

GET/api/analysis/defection-trackerParty switches and defections

GET/api/analysis/sector-flowsSector influence map (Sankey)

GET/api/analysis/expense-mapGeographic expense data

GET/api/analysis/conflictsConflict of interest detection

GET/api/analysis/donor-contractsDonor to government contract links

GET/api/analysis/corporate-finesCorporate fines from donors

GET/api/analysis/council-distressCouncil financial distress indicators

GET/api/analysis/migration-costsFiscal impact of internal migration

GET/api/analysis/national-financesNational finance overview

GET/api/analysis/religion-demographicsReligion and demographics

GET/api/winnabilitySeat winnability analysis

GET/api/winnability/:idIndividual seat winnability

GET/api/headlinesAuto-generated data headlines

Common Query Parameters

limitNumber of results (default: 100, max: 500)

offsetPagination offset for large result sets

searchText search filter (where applicable)

partyFilter by political party

yearFilter by year (e.g., expenses, elections)

Authentication Required

Programmatic API access requires an API key. Website browsing uses the data freely, but direct API calls from scripts, applications, or external services must authenticate.

curl -H "x-api-key: YOUR_API_KEY" https://civiccoreinstitute.com/api/mps

Rate Limits

Authenticated access: 100 requests/minute (free tier), 5000 requests/minute (paid tier).

Data Sources

UK Parliament API

IPSA (MP Expenses)

Electoral Commission

Companies House

GOV.UK Publications

Police.uk Crime Data

Democracy Club

MySociety Historical Archive

DWP Stat-Xplore (Benefits)

ONS / NOMIS (Demographics)

Home Office (Immigration)

MOJ (Courts & Justice)

ONS Census 2021 (Ethnicity)

UK HPI / Land Registry

DfE (Education & KS4)

Contracts Finder (OCDS)

Focaldata / Election Maps UK (Polling)

Charity Commission

Need Higher Rate Limits?

// Example: GET /api/mps?limit=2 { "mps": [ { "id": "1", "fullName": "Keir Starmer", "party": "Labour", ... }, { "id": "2", "fullName": "Rishi Sunak", "party": "Conservative", ... } ], "pagination": { "total": 650, "limit": 2, "offset": 0, "hasMore": true } }