add_expense

Record something one person paid for the group. Split equally by default; pass split_between for a subset, or shares for an uneven split. One expense covers one set of people — a receipt whose items aren't all shared by everyone is several expenses, so call this once per group of items that the same people share, rather than splitting the total equally. Works on simple, accountless splits. Secure splits (created by a signed-in user) are read-only here and must be opened in a browser.

Argument	Type	Description
date	string	Date as YYYY-MM-DD. Defaults to today.
split*	string	The split key, or the whole https://split.xuper.fun/k/<key> link.
amount*	number	Amount in the split's currency, as a decimal (e.g. 249.50).
shares	array	Uneven split. Either an exact `amount` per person (must add up to the total) or a relative `weight` per person (e.g. weight 2 for a couple). Don't combine with split_between.
paid_by*	string	Who paid — a participant's name (or id) in this split. A card receipt rarely names the payer, so ask unless you know: guess wrong and every balance points the wrong way. If the user counts themselves among the participants, assume it was them and say that you assumed it — what you must not do is pick a payer silently.
description	string	What it was, e.g. "Groceries".
split_between	array	Names of the people sharing this cost, split equally. Defaults to everyone.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "split",
    "amount",
    "paid_by"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Date as YYYY-MM-DD. Defaults to today."
    },
    "split": {
      "type": "string",
      "description": "The split key, or the whole https://split.xuper.fun/k/<key> link."
    },
    "amount": {
      "type": "number",
      "description": "Amount in the split's currency, as a decimal (e.g. 249.50).",
      "exclusiveMinimum": 0
    },
    "shares": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "participant"
        ],
        "properties": {
          "amount": {
            "type": "number",
            "exclusiveMinimum": 0
          },
          "weight": {
            "type": "number",
            "exclusiveMinimum": 0
          },
          "participant": {
            "type": "string"
          }
        }
      },
      "description": "Uneven split. Either an exact `amount` per person (must add up to the total) or a relative `weight` per person (e.g. weight 2 for a couple). Don't combine with split_between."
    },
    "paid_by": {
      "type": "string",
      "description": "Who paid — a participant's name (or id) in this split. A card receipt rarely names the payer, so ask unless you know: guess wrong and every balance points the wrong way. If the user counts themselves among the participants, assume it was them and say that you assumed it — what you must not do is pick a payer silently."
    },
    "description": {
      "type": "string",
      "description": "What it was, e.g. \"Groceries\"."
    },
    "split_between": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Names of the people sharing this cost, split equally. Defaults to everyone."
    }
  }
}

add_participant

Add someone to an existing split. Works on simple, accountless splits. Secure splits (created by a signed-in user) are read-only here and must be opened in a browser.

Argument	Type	Description
name*	string
split*	string	The split key, or the whole https://split.xuper.fun/k/<key> link.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "split",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1
    },
    "split": {
      "type": "string",
      "description": "The split key, or the whole https://split.xuper.fun/k/<key> link."
    }
  }
}

create_split

Create a new xupersplit for sharing expenses in a group. No account needed. Returns a secret link — give it to the user and tell them to share it with the group, since anyone holding the link can see and edit the split.

Argument	Type	Description
title*	string	What the split is for, e.g. "Ski trip".
currency	string	Currency code. Defaults to SEK.
participants*	array	Names of everyone splitting, at least two.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "title",
    "participants"
  ],
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "description": "What the split is for, e.g. \"Ski trip\"."
    },
    "currency": {
      "enum": [
        "SEK",
        "EUR",
        "USD",
        "NOK",
        "DKK",
        "ISK",
        "GBP",
        "CHF",
        "PLN",
        "THB",
        "SATS"
      ],
      "type": "string",
      "description": "Currency code. Defaults to SEK."
    },
    "participants": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "minItems": 2,
      "description": "Names of everyone splitting, at least two."
    }
  }
}

delete_entry

Remove an expense or payment for good. Works on simple, accountless splits. Secure splits (created by a signed-in user) are read-only here and must be opened in a browser.

destructive

Argument	Type	Description
split*	string	The split key, or the whole https://split.xuper.fun/k/<key> link.
entry_id*	string	The entry's id, from get_split.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "split",
    "entry_id"
  ],
  "properties": {
    "split": {
      "type": "string",
      "description": "The split key, or the whole https://split.xuper.fun/k/<key> link."
    },
    "entry_id": {
      "type": "string",
      "description": "The entry's id, from get_split."
    }
  }
}

get_split

Read a split: participants, expenses, per-person balances and the shortest set of payments that settles everyone up.

read-only

Argument	Type	Description
split*	string	The split key, or the whole https://split.xuper.fun/k/<key> link.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "split"
  ],
  "properties": {
    "split": {
      "type": "string",
      "description": "The split key, or the whole https://split.xuper.fun/k/<key> link."
    }
  }
}

record_payment

Record that one person paid another back, settling part or all of a debt. Use get_split first to see who should pay whom. Works on simple, accountless splits. Secure splits (created by a signed-in user) are read-only here and must be opened in a browser.

Argument	Type	Description
to*	string	Who received it — a participant's name (or id) in this split.
date	string	Date as YYYY-MM-DD. Defaults to today.
from*	string	Who sent the money — a participant's name (or id) in this split.
split*	string	The split key, or the whole https://split.xuper.fun/k/<key> link.
amount*	number	Amount in the split's currency, as a decimal (e.g. 249.50).
description	string	How it was paid, e.g. "Swish, 3 March". Shown in the history.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "split",
    "from",
    "to",
    "amount"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Who received it — a participant's name (or id) in this split."
    },
    "date": {
      "type": "string",
      "description": "Date as YYYY-MM-DD. Defaults to today."
    },
    "from": {
      "type": "string",
      "description": "Who sent the money — a participant's name (or id) in this split."
    },
    "split": {
      "type": "string",
      "description": "The split key, or the whole https://split.xuper.fun/k/<key> link."
    },
    "amount": {
      "type": "number",
      "description": "Amount in the split's currency, as a decimal (e.g. 249.50).",
      "exclusiveMinimum": 0
    },
    "description": {
      "type": "string",
      "description": "How it was paid, e.g. \"Swish, 3 March\". Shown in the history."
    }
  }
}

remove_participant

Remove someone from a split. Only works if they aren't on any expense yet. Works on simple, accountless splits. Secure splits (created by a signed-in user) are read-only here and must be opened in a browser.

destructive

Argument	Type	Description
split*	string	The split key, or the whole https://split.xuper.fun/k/<key> link.
participant*	string	Who to remove — a participant's name (or id) in this split.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "split",
    "participant"
  ],
  "properties": {
    "split": {
      "type": "string",
      "description": "The split key, or the whole https://split.xuper.fun/k/<key> link."
    },
    "participant": {
      "type": "string",
      "description": "Who to remove — a participant's name (or id) in this split."
    }
  }
}

rename_participant

Change a participant's name. Works on simple, accountless splits. Secure splits (created by a signed-in user) are read-only here and must be opened in a browser.

Argument	Type	Description
name*	string	The new name.
split*	string	The split key, or the whole https://split.xuper.fun/k/<key> link.
participant*	string	Who to rename — a participant's name (or id) in this split.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "split",
    "participant",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "The new name."
    },
    "split": {
      "type": "string",
      "description": "The split key, or the whole https://split.xuper.fun/k/<key> link."
    },
    "participant": {
      "type": "string",
      "description": "Who to rename — a participant's name (or id) in this split."
    }
  }
}

set_payment_methods

Set how a participant wants to be paid back, so the split can show a QR code or pay link. Replaces their current list (pass an empty array to clear it). Works on simple, accountless splits. Secure splits (created by a signed-in user) are read-only here and must be opened in a browser.

destructive

Argument	Type	Description
split*	string	The split key, or the whole https://split.xuper.fun/k/<key> link.
methods*	array
participant*	string	Whose details these are — a participant's name (or id) in this split.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "split",
    "participant",
    "methods"
  ],
  "properties": {
    "split": {
      "type": "string",
      "description": "The split key, or the whole https://split.xuper.fun/k/<key> link."
    },
    "methods": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "type",
          "value"
        ],
        "properties": {
          "type": {
            "enum": [
              "swish",
              "vipps",
              "mobilepay",
              "revolut",
              "lightning",
              "evm",
              "solana",
              "iban"
            ],
            "type": "string"
          },
          "value": {
            "type": "string",
            "description": "Phone number for swish/vipps/mobilepay, IBAN, Revolut tag, Lightning address, 0x/ENS address, or Solana address."
          }
        }
      },
      "maxItems": 8
    },
    "participant": {
      "type": "string",
      "description": "Whose details these are — a participant's name (or id) in this split."
    }
  }
}

update_entry

Change an existing expense or payment. Only the fields you pass are changed. Entry ids come from get_split. Works on simple, accountless splits. Secure splits (created by a signed-in user) are read-only here and must be opened in a browser.

Argument	Type	Description
to	string	New recipient — payments only.
date	string	Date as YYYY-MM-DD. Defaults to today.
split*	string	The split key, or the whole https://split.xuper.fun/k/<key> link.
amount	number	Amount in the split's currency, as a decimal (e.g. 249.50).
shares	array	Uneven split. Either an exact `amount` per person (must add up to the total) or a relative `weight` per person (e.g. weight 2 for a couple). Don't combine with split_between.
paid_by	string	Move the entry to a different payer.
entry_id*	string	The entry's id, from get_split.
description	string
split_between	array

update_split

Change a split's title or currency. The currency is locked once the split has expenses. Works on simple, accountless splits. Secure splits (created by a signed-in user) are read-only here and must be opened in a browser.

Argument	Type	Description
split*	string	The split key, or the whole https://split.xuper.fun/k/<key> link.
title	string
currency	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "split"
  ],
  "properties": {
    "split": {
      "type": "string",
      "description": "The split key, or the whole https://split.xuper.fun/k/<key> link."
    },
    "title": {
      "type": "string",
      "minLength": 1
    },
    "currency": {
      "enum": [
        "SEK",
        "EUR",
        "USD",
        "NOK",
        "DKK",
        "ISK",
        "GBP",
        "CHF",
        "PLN",
        "THB",
        "SATS"
      ],
      "type": "string"
    }
  }
}

xupersplit

Try it

add_expense

xupersplit

Try it

add_expense

Tools (11)