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

# Get a party



## OpenAPI

````yaml /openapi.json get /parties/{partyId}
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/{partyId}:
    get:
      summary: Get a party
      operationId: getParty
      parameters:
        - name: partyId
          in: path
          required: true
          description: The party's id.
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: The party's profile and record.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartyProfile'
        '400':
          description: The request was malformed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: No such party.
          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:
    PartyProfile:
      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.
          type:
            - string
            - 'null'
        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.
        websiteUrl:
          type:
            - string
            - 'null'
        color:
          description: 'The leader''s chosen color as #rrggbb, or null for the default.'
          type:
            - string
            - 'null'
        updatedAt:
          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.
        dissolvedAt:
          anyOf:
            - 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.
            - type: 'null'
        subsidiesAllocated:
          description: >-
            WDD allocated to the party in party subsidies, across all elections;
            each allocation is released over 365 days. Null where the
            allocations could not be read.
          type:
            - number
            - 'null'
        electionRecord:
          type: array
          items:
            type: object
            properties:
              electionId:
                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})$
              votes:
                type: integer
                minimum: -9007199254740991
                maximum: 9007199254740991
              electionTotalVotes:
                type: integer
                minimum: -9007199254740991
                maximum: 9007199254740991
              rank:
                type: integer
                minimum: -9007199254740991
                maximum: 9007199254740991
                description: 1-based.
              partiesWithVotes:
                type: integer
                minimum: -9007199254740991
                maximum: 9007199254740991
              seats:
                anyOf:
                  - type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                  - type: 'null'
                description: Seats won, for an election allocated by seats; else null.
              subsidyAllocated:
                description: >-
                  WDD allocated to the party for this election, released over
                  365 days. Null when nothing was allocated (not yet
                  distributed, or forfeited) or the allocations could not be
                  read; never a zero standing in for either.
                type:
                  - number
                  - 'null'
            required:
              - electionId
              - votes
              - electionTotalVotes
              - rank
              - partiesWithVotes
              - seats
              - subsidyAllocated
            additionalProperties: false
          description: The party's results in closed test elections.
      required:
        - id
        - name
        - description
        - leaderUsername
        - registeredAt
        - listed
        - moderation
        - url
        - websiteUrl
        - color
        - updatedAt
        - dissolvedAt
        - subsidiesAllocated
        - electionRecord
      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

````

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