Skip to content

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/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: 140k+ procurement notices (awards and tenders)

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/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/economy/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

Subscribe to get a key straight away (see pricing), or email research@civiccoreinstitute.com about academic or journalism access.

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?

Contact us for enterprise API access with higher limits and priority support.

Contact Us