Developer API

Public Mandate API

Free and open access to political accountability data. Build apps, dashboards, and research tools.

Demo API Key

Use this key for testing and development

pm_live_public_mandate_demo_key

Base URL

https://api.publicmandate.com/api/v1

All endpoints are HTTPS only

API Endpoints

GET/api/v1/pm/open/countries

Get all countries with their details

GET/api/v1/pm/open/stats/platform

Get platform-wide statistics

GET/api/v1/pm/open/politicians

Get politicians with optional filters

GET/api/v1/pm/open/politicians/:slug

Get detailed politician information

GET/api/v1/pm/open/politicians/:slug/promises

Get promises by a specific politician

GET/api/v1/pm/open/promises/:id/votes

Get vote statistics for a promise

Example Request

GET /api/v1/pm/open/stats/platform

curl -X GET 'https://api.publicmandate.com/api/v1/pm/open/stats/platform' \
  -H 'Authorization: Bearer pm_live_public_mandate_demo_key'

Example Response

{
  "verifiedPoliticians": 124,
  "totalPromises": 1247,
  "completedPromises": 342,
  "promiseCompletionRate": 27.4,
  "activeCitizens": 15678,
  "totalValidationVotes": 45678,
  "totalCountries": 53,
  "lastUpdated": "2024-01-15T10:30:00Z"
}

Rate Limits

Free tier: 1000 requests per day

Higher limits available for researchers and media partners

Authentication

All API requests require an API key sent in the Authorization header:

Authorization: Bearer your_api_key_here