API & open data
Every entity, claim, source and experiment is available as structured data. Reading needs no key; generous rate limits apply.
Authentication
Reading is anonymous. Writing uses the Django session cookie: fetch GET /auth/csrf once, then send the token as X-CSRFToken on POST, PATCH and DELETE with credentials included.
Pagination & errors
Lists take page and page_size and return {"items", "count", "page", "page_size"}. Errors are always {"detail": "…"} with a meaningful status (400, 401, 403, 404, 409, 422, 429).
Localisation
Add ?lang=ru (or send Accept-Language) for Russian fields; missing translations fall back to English.
/entities/{slug}
Returns an entity with its relations grouped by type, its claims with evidence and sources, and assessments.
curl "https://polityatlas.org/api/v1/entities/polycentric-law?lang=en"
import httpx
r = httpx.get("https://polityatlas.org/api/v1/entities/polycentric-law?lang=en")
entity = r.json()const res = await fetch("https://polityatlas.org/api/v1/entities/polycentric-law?lang=en");
const entity = await res.json();{
"id": 11,
"slug": "polycentric-law",
"kind": "concept",
"title": "Polycentric law",
"summary": "Several coexisting centres of rule-making and dispute resolution.",
"review_state": "published",
"last_verified_at": "2026-10-02T00:00:00Z",
"relations": [
{
"type": "implements",
"direction": "incoming",
"label": "implemented by",
"items": [{ "entity": { "slug": "arbitration", "kind": "mechanism" } }]
}
],
"claims": [{
"id": 318,
"text": "…",
"epistemic_status": "disputed",
"verification_status": "verified",
"evidence": [{ "stance": "supports", "source": { "id": 41 } }]
}]
}Knowledge
Living Atlas
Explorer & Observatory
Polity Lab
Ontology
The vocabulary every record uses. Editors can fetch the full schema, including attribute definitions, from /cp/ontology.
conceptMechanismmechanismTheorytheoryThinkerthinkerExperimentexperimentInstitution typeinstitution_typeIdeologyideologyorganisationorganisationimplementstested intested_inproposed byproposed_byinfluencedinfluencedcriticisescriticisesalternativealternative_topart ofpart_ofuses mechanismuses_mechanismrelated torelated_toestablishedTheorytheoryDisputeddisputedHypothesishypothesisForecastforecastunverifiedAI-draftedai_draftedIn reviewin_reviewVerifiedverifiedRejectedrejected