> ## Documentation Index
> Fetch the complete documentation index at: https://docs.worldrepublic.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Citizen and party counts



## OpenAPI

````yaml /openapi.json get /stats
openapi: 3.1.0
info:
  title: World Republic public API
  version: 1.0.0
  description: >-
    Read-only access to the World Republic's public data: the party registry,
    test elections and their results, the party subsidies allocated to each
    party, and counts of verified citizens and parties. No sign-in. Test
    elections are experimental and non-binding; they are not public elections.
    Per-party results are published only after an election closes. Party names
    and descriptions are written by party leaders. The same reads are available
    to AI assistants through the MCP server at
    https://www.worldrepublic.org/api/mcp.
  termsOfService: https://www.worldrepublic.org/en/legal/terms
servers:
  - url: https://www.worldrepublic.org/api/v1
security: []
externalDocs:
  url: https://docs.worldrepublic.org
paths:
  /stats:
    get:
      summary: Citizen and party counts
      operationId: getStats
      responses:
        '200':
          description: Verified citizens and parties.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Stats'
        '503':
          description: >-
            The data could not be read just now, or search was over its limit.
            Retry after the Retry-After header.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Stats:
      type: object
      properties:
        verifiedCitizens:
          anyOf:
            - type: integer
              minimum: -9007199254740991
              maximum: 9007199254740991
            - type: 'null'
        parties:
          type: object
          properties:
            listed:
              anyOf:
                - type: integer
                  minimum: -9007199254740991
                  maximum: 9007199254740991
                - type: 'null'
              description: 'Parties in the default list: cleared by moderation.'
            includingUnlisted:
              anyOf:
                - type: integer
                  minimum: -9007199254740991
                  maximum: 9007199254740991
                - type: 'null'
              description: >-
                Also counting parties still awaiting moderation review and
                parties flagged as spam.
          required:
            - listed
            - includingUnlisted
          additionalProperties: false
      required:
        - verifiedCitizens
        - parties
      additionalProperties: false
      description: Null where a figure could not be read just now.
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - invalid_request
                - not_found
                - unavailable
            message:
              type: string
          required:
            - code
            - message
      required:
        - error

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.