Partner data & API

Read-only endpoints for MPs, the public commitment catalogue, the People's Report Card, and research exports. This page is a public summary of how we expect partners to use them — not a substitute for legal advice or a signed agreement.

Programme summary. Confirm wording with MBKRU before citing this page as contractual terms in agreements or public statements.

What is available

When parliament and catalogue features are enabled for this site, MBKRU exposes GET JSON and UTF-8 CSV exports. Each handler may return 404 or 503 when data or the database is unavailable — design integrations to degrade gracefully.

/api/mps
Active MP/minister roster (when commitment catalogue is enabled on this site).
/api/promises
Tracked commitments via GET /api/promises with optional filters; JSON responses are capped — use CSV for full exports.
/api/report-card/[year]
Published People's Report Card cycle when the report card is public on this site.
/api/export/mps-csv
CSV roster (same feature gate as JSON MPs).
/api/export/promises-csv
Full promise export with the same filter semantics as JSON (separate rate bucket).

Path	Purpose
/api/mps	Active MP/minister roster (when commitment catalogue is enabled on this site).
/api/promises	Tracked commitments via GET /api/promises with optional filters; JSON responses are capped — use CSV for full exports.
/api/report-card/[year]	Published People's Report Card cycle when the report card is public on this site.
/api/export/mps-csv	CSV roster (same feature gate as JSON MPs).
/api/export/promises-csv	Full promise export with the same filter semantics as JSON (separate rate bucket).

GET /api/health reports capability flags for monitoring — it is not a dataset export.

Caching and traffic

Successful responses advertise Cache-Control suitable for shared caches; respect those headers and avoid hammering origin.
Expect 429 Too Many Requests when rate limits apply — back off and retry with exponential delay.
After editors publish updates, we use cache revalidation so partners often see fresh data without waiting for the full edge TTL.

Attribution and accuracy

Attribute MBKRU when you display derived tables, charts, or excerpts.
Do not imply endorsement by MBKRU, Parliament, or government bodies.
Surface methodology and update context where you can; datasets are compiled for civic accountability and may be corrected after editorial or legal review.
Data is provided as-is, without warranty — partners should not treat exports as sole evidence in litigation or regulatory filings without independent verification.

Versioning

URLs today do not include a version segment. Before breaking response shapes, we expect to introduce explicit versioning (for example /api/v1/... aliases or Accept negotiation) with a deprecation window — watch release notes and docs/PARTNER_API.md in the repository.

Get in touch

For traffic expectations, attribution assets, or a formal partnership conversation, use our Contact page and choose a partnership-oriented enquiry where the form allows it.

Accountability methodology Claims & citations Data sources Site terms of use

Loading…

What is available

/api/mps

Active MP/minister roster (when commitment catalogue is enabled on this site).

/api/promises

Tracked commitments via GET /api/promises with optional filters; JSON responses are capped — use CSV for full exports.

/api/report-card/[year]

Published People's Report Card cycle when the report card is public on this site.

/api/export/mps-csv

CSV roster (same feature gate as JSON MPs).

/api/export/promises-csv

Full promise export with the same filter semantics as JSON (separate rate bucket).

Path	Purpose
/api/mps	Active MP/minister roster (when commitment catalogue is enabled on this site).
/api/promises	Tracked commitments via GET /api/promises with optional filters; JSON responses are capped — use CSV for full exports.
/api/report-card/[year]	Published People's Report Card cycle when the report card is public on this site.
/api/export/mps-csv	CSV roster (same feature gate as JSON MPs).
/api/export/promises-csv	Full promise export with the same filter semantics as JSON (separate rate bucket).

GET /api/health reports capability flags for monitoring — it is not a dataset export.

Caching and traffic

Successful responses advertise Cache-Control suitable for shared caches; respect those headers and avoid hammering origin.

Expect 429 Too Many Requests when rate limits apply — back off and retry with exponential delay.

After editors publish updates, we use cache revalidation so partners often see fresh data without waiting for the full edge TTL.

Attribution and accuracy

Attribute MBKRU when you display derived tables, charts, or excerpts.

Do not imply endorsement by MBKRU, Parliament, or government bodies.

Surface methodology and update context where you can; datasets are compiled for civic accountability and may be corrected after editorial or legal review.

Data is provided as-is, without warranty — partners should not treat exports as sole evidence in litigation or regulatory filings without independent verification.