> ## 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.

# List or search parties

> 100 per page, newest first unless sort ranks the whole registry by votes or by subsidies allocated; a ranked list carries each party's figure. Descriptions are shortened in lists. The default list holds parties cleared by moderation; includeUnlisted adds parties still awaiting moderation review and parties flagged as spam.



## OpenAPI

````yaml /openapi.json get /parties
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:
  /parties:
    get:
      summary: List or search parties
      description: >-
        100 per page, newest first unless sort ranks the whole registry by votes
        or by subsidies allocated; a ranked list carries each party's figure.
        Descriptions are shortened in lists. The default list holds parties
        cleared by moderation; includeUnlisted adds parties still awaiting
        moderation review and parties flagged as spam.
      operationId: listParties
      parameters:
        - name: search
          in: query
          description: Matches party names, descriptions and leader usernames.
          schema:
            type: string
            maxLength: 256
        - name: offset
          in: query
          description: 0, or the nextOffset of the previous page (a multiple of 100).
          schema:
            type: integer
            minimum: 0
        - name: includeUnlisted
          in: query
          description: >-
            Also return parties still awaiting moderation review and parties
            flagged as spam.
          schema:
            type: boolean
            default: false
        - name: sort
          in: query
          description: >-
            newest, votes (drawn in closed test elections) or subsidies
            (allocated). A ranking cannot be combined with search, and its
            offset is at most 20000.
          schema:
            type: string
            enum:
              - newest
              - votes
              - subsidies
            default: newest
      responses:
        '200':
          description: A page of parties.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartyPage'
        '400':
          description: The request was malformed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '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:
    PartyPage:
      type: object
      properties:
        parties:
          type: array
          items:
            $ref: '#/components/schemas/PartySummary'
        nextOffset:
          anyOf:
            - type: integer
              minimum: -9007199254740991
              maximum: 9007199254740991
            - type: 'null'
          description: Pass as offset to read the next page; null on the last page.
        total:
          anyOf:
            - type: integer
              minimum: -9007199254740991
              maximum: 9007199254740991
            - type: 'null'
          description: >-
            Matches in total, for the first page of a search only; null
            otherwise.
      required:
        - parties
        - nextOffset
        - total
      additionalProperties: false
    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
    PartySummary:
      type: object
      properties:
        id:
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
        name:
          type: string
        description:
          description: >-
            Written by the party's leader. At most 200 characters in a list; see
            descriptionTruncated.
          type:
            - string
            - 'null'
        descriptionTruncated:
          type: boolean
        leaderUsername:
          type: string
          description: The public username of the citizen who leads the party.
        registeredAt:
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
          description: ISO 8601 timestamp, UTC.
        listed:
          type: boolean
          description: >-
            Whether the party appears in the registry's default list. An
            unlisted party is still reachable at its own address.
        moderation:
          type: string
          enum:
            - clear
            - in_review
            - flagged_as_spam
          description: >-
            The party's moderation standing. Only cleared parties are in the
            default list; the others are returned when includeUnlisted is set.
        url:
          type: string
          format: uri
          description: The party's page in the app.
        totalVotes:
          anyOf:
            - type: integer
              minimum: -9007199254740991
              maximum: 9007199254740991
            - type: 'null'
          description: >-
            Votes the party drew across closed test elections. Set when the list
            is sorted by votes; null otherwise.
        subsidiesAllocated:
          description: >-
            WDD allocated to the party in party subsidies, across all elections;
            each allocation is released over 365 days. Set when the list is
            sorted by subsidies; null otherwise, or where the allocations could
            not be read.
          type:
            - number
            - 'null'
      required:
        - id
        - name
        - description
        - descriptionTruncated
        - leaderUsername
        - registeredAt
        - listed
        - moderation
        - url
        - totalVotes
        - subsidiesAllocated
      additionalProperties: false
      description: >-
        A party in the World Republic's registry. Names and descriptions are
        written by party leaders, not by the World Republic.

````

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