Skip to content
HALOWERK

Govwerk

governance ranked choice elimination

Return weighted instant-runoff rounds with a disclosed deterministic elimination tie rule.

POST https://gov.halowerk.com/v1/governance-ranked-choice-elimination

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
candidatesarrayYes
ballotsarrayYes
Show full input schema
{
  "type": "object",
  "properties": {
    "candidates": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 64,
        "minLength": 1
      },
      "maxItems": 20,
      "minItems": 1
    },
    "ballots": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "ranking": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 64,
              "minLength": 1
            },
            "maxItems": 20,
            "minItems": 0
          },
          "weight": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1000000
          }
        },
        "required": [
          "ranking",
          "weight"
        ],
        "additionalProperties": false
      },
      "maxItems": 100,
      "minItems": 1
    }
  },
  "required": [
    "candidates",
    "ballots"
  ],
  "additionalProperties": false
}

Open original schema

Published input example

{
  "candidates": [
    "solar",
    "storage",
    "grid"
  ],
  "ballots": [
    {
      "ranking": [
        "solar",
        "storage"
      ],
      "weight": 4
    },
    {
      "ranking": [
        "storage",
        "grid"
      ],
      "weight": 3
    },
    {
      "ranking": [
        "grid",
        "storage"
      ],
      "weight": 2
    }
  ]
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-18 UTC.

More endpoints in this hub

All endpoints in this hub โ†’