Reference API reference
Live from the production OpenAPI spec — always in sync. Open interactive reference → Authentication Raw spec ← All docs

Leaders catalog — /v1/leaders

A transparent, filterable view of the country-anchored leaders index: exactly which head-of-state and head-of-government holders (and, optionally, their relatives) we hold, country by country, with the dates each person was in office and a link back to the Wikidata source on every row. Read-only reference data — identical for every tenant — but still gated on a tenant credential (Authorization: Bearer <oidc> or X-Api-Key: aml_…) with the Screening.Read scope, like the other data endpoints.

EndpointDescription
GET /v1/leadersPaginated JSON; one row per leadership term (person × office × term).
GET /v1/leaders/export.csvThe same filtered rows flattened to a CSV download (ignores paging — exports the full filtered set).

Filters & paging (query parameters)

ParamTypeDescription
countrystring, repeatableISO alpha-2 code(s), e.g. ?country=US&country=GB. Omitted = every country.
roleenumhead_of_state or head_of_government. Omitted = both. Unknown values are ignored.
statusenumcurrent (open-ended terms), historical (ended terms) or all (default).
yearFromintOnly terms overlapping on/after this year. Defaults to 25 years back when omitted (the view is trimmed; full history is retained).
yearTointOnly terms overlapping on/before this year. Omitted = no upper bound (current terms always shown).
includeRelativesboolDefault false. When true, appends each returned leader’s relatives (PEP4) with a relativeOf link.
qstringCase-insensitive substring match on the person’s name.
prioritizeboolOrder main European countries + BRIC (Brazil/Russia/India/China) first (configurable priority list), then country, then term start desc. Default sort is country then term start desc.
pageint1-based page number (default 1).
pageSizeintRows per page (default 50, capped at 200).

pepClass — what it means

pepClassApplies to
PEP1A national office-holder (a domestic leader by their office jurisdiction).
PEP3A senior role in an international / intergovernmental organization.
PEP4A family member or close associate of a leader (relatives pass).
Customer-relative caveat (be clear on this). This raw catalog shows a national leader as PEP1 keyed off their office jurisdiction. The FATF PEP1 Domestic vs PEP2 Foreign split is applied per customer at screen time, relative to that customer’s own home country — a leader who is PEP1 (domestic) for one tenant is PEP2 (foreign) for another. That grading is not baked into this view; it happens during screening. PEP3 and PEP4 are absolute and identical for every customer.

Example response — GET /v1/leaders?country=FR&status=current&includeRelatives=true

{
  "items": [
    {
      "person": "Emmanuel Macron",
      "qid": "Q3052772",
      "dob": "1977-12-21",
      "personUrl": "https://www.wikidata.org/wiki/Q3052772",
      "countryIso": "FR",
      "country": "France",
      "countryQid": "Q142",
      "office": "President of France",
      "officeQid": "Q191954",
      "officeUrl": "https://www.wikidata.org/wiki/Q191954",
      "role": "head_of_state",
      "termStart": "2017-05-14",
      "termEnd": null,
      "isCurrent": true,
      "pepClass": "PEP1",
      "pepClassLabel": "National leader (Domestic/Foreign applied per customer at screen time)",
      "relativeOf": null
    },
    {
      "person": "Brigitte Macron",
      "qid": "Q259357",
      "dob": "1953-04-13",
      "personUrl": "https://www.wikidata.org/wiki/Q259357",
      "countryIso": null,
      "country": null,
      "office": null,
      "role": null,
      "termStart": null,
      "termEnd": null,
      "isCurrent": false,
      "pepClass": "PEP4",
      "pepClassLabel": "Family member or close associate",
      "relativeOf": { "qid": "Q3052772", "name": "Emmanuel Macron" }
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 50
}

total counts the leadership term rows matching the filters (before paging); relatives, when requested, are appended for the leaders on the returned page and are not counted in total. The CSV export flattens the same rows to the columns: person, qid, personUrl, countryIso, country, office, officeQid, officeUrl, role, termStart, termEnd, isCurrent, pepClass, relativeOf.

Explore every endpoint interactively

The full interactive OpenAPI reference — try requests, browse schemas and status codes — is served self-contained (no third-party CDN) from the production spec. It always stays in sync with the live API.

Prefer Swagger UI? Open the classic explorer →
Open interactive reference →