Zum Inhalt
HALOWERK

Creatorwerk

royalty split

Requires shares totaling exactly 10,000 basis points, floors each proportional minor-unit allocation, and distributes leftover units by descending fractional remainder with a stable name tie-break. It performs arithmetic only and does not transfer funds, interpret contracts, withhold tax or resolve rights ownership.

POST https://creator.halowerk.com/v1/royalty-split

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
total_minor_unitsintegerJaWhole minor currency units, for example cents; bounded so basis-point products remain exact JavaScript integers.
currencystringJa
recipientsarrayJa
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "total_minor_units",
    "currency",
    "recipients"
  ],
  "additionalProperties": false,
  "properties": {
    "total_minor_units": {
      "type": "integer",
      "minimum": 0,
      "maximum": 900000000000,
      "description": "Whole minor currency units, for example cents; bounded so basis-point products remain exact JavaScript integers."
    },
    "currency": {
      "type": "string",
      "minLength": 3,
      "maxLength": 12,
      "pattern": "^[A-Z0-9_-]+$"
    },
    "recipients": {
      "type": "array",
      "minItems": 1,
      "maxItems": 1000,
      "items": {
        "type": "object",
        "required": [
          "name",
          "share_basis_points"
        ],
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          },
          "share_basis_points": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000
          }
        }
      }
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "total_minor_units": 125037,
  "currency": "EUR",
  "recipients": [
    {
      "name": "writer",
      "share_basis_points": 5000
    },
    {
      "name": "performer",
      "share_basis_points": 3250
    },
    {
      "name": "producer",
      "share_basis_points": 1750
    }
  ]
}

Ergebnis & Dokumentation

Veröffentlichtes Ergebnisschema anzeigen
{
  "$ref": "https://creator.halowerk.com/v1/royalty-split/schema#/outputSchema"
}

Veröffentlichtes Ergebnisbeispiel öffnen

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →