Britain Next
AboutCitizen reports

For newsrooms, researchers, and civic tech

Cite our data, programmatically.

Every published dataset on Britain Next is a public JSON or CSV endpoint: MPs and their Commons votes and registered interests, Westminster constituencies, public notices, and citizen reports that cleared moderation. No key required. Open CORS. Every record carries its own source URL back to the official publisher.

Quick start

# discover every dataset in one call

curl https://www.britainnext.co.uk/api/v1

# MPs as JSON

curl https://www.britainnext.co.uk/api/v1/representatives

# same data as CSV for spreadsheets

curl https://www.britainnext.co.uk/api/v1/representatives?format=csv

# one MP with votes and interests

curl https://www.britainnext.co.uk/api/v1/representatives/{slug}

Every response is wrapped in { "_meta": { … }, "data": … }, where _meta carries the publisher, licence, and a source note.

Discovery

  • GET/api/v1

    API catalogue: every dataset with a live row count. The one call that discovers the whole surface.

  • GET/api/v1/openapi.json

    OpenAPI 3.1 description for Swagger UI, Postman, code generators, and agents.

MPs and constituencies

  • GET/api/v1/representativesalso CSV via ?format=csv

    Directory of published MPs. Filter by ?party= ?limit=.

  • GET/api/v1/representatives/{slug}

    One MP in full: role, party, recent Commons votes (position and division date), and registered financial interests. Every row carries its own source URL.

  • GET/api/v1/constituenciesalso CSV via ?format=csv

    Westminster constituencies mapped to their sitting MP. Filter by ?nation= ?limit=.

Notices and citizen reports

  • GET/api/v1/noticesalso CSV via ?format=csv

    Published public notices, each linked to its official source. Filter by ?type= ?region= ?limit=.

  • GET/api/v1/reportsalso CSV via ?format=csv

    Citizen reports that cleared moderation. Filter by ?category= ?limit=. Reporter identity is never included.

Conventions

Stable v1 contract

Additive changes only. Breaking changes go to /api/v2. Fields are deprecated, never silently removed.

Open CORS, no key

All endpoints respond Access-Control-Allow-Origin: *. Fetch from any origin.

Caching

Every response carries a strong ETag and Cache-Control. Use conditional GETs and cache freely.

Published data only

The API serves only what the public site shows. Citizen-report reader identity is never included.

Licence

The Britain Next compilation is licensed CC BY 4.0. Underlying official data remains under the Open Government Licence v3.0. Attribute Britain Next, with a link, and verify each record against the source URL it carries.

“Source: Britain Next (britainnext.co.uk), verified against [official publisher].”

Building on this data?

We would like to know. Read the machine-readable spec at /api/v1/openapi.json, and see our source policy and corrections policy for how the underlying records are verified and put right.