Splitwise

App · 14 actions

Share costs with Splitwise: add expenses split with a group or a friend, see who owes whom, and comment on expenses. Start a workflow when an expense is added.

Actions

ActionWhat it does
Add expenseAdd an expense, split equally in a group or between you and a friend.
Change expenseChange an expense's description, amount, date or notes.
Comment on expenseAdd a comment to an expense, which everyone on it sees.
Create groupMake a group with just you in it, such as for a trip or a household.
Delete expenseDelete an expense.
Delete groupDelete a group and its expenses.
Get expenseGet one expense: its cost, who paid and who owes what.
Get groupGet one group: its members and who owes whom.
Get my accountGet your Splitwise name, email and default currency.
List commentsList an expense's comments, oldest first, including the ones Splitwise adds when it changes.
List expensesList expenses, newest first, in a group or with a friend, between two dates.
List friendsList your friends, with what each owes you (positive) or you owe them (negative).
List groupsList your groups, with who owes whom in each.
Restore expenseBring back a deleted expense.

Add expense

Add an expense, split equally in a group or between you and a friend. Splitwise tells the others.

Inputs

DescriptiondescriptiontextRequired
What it was for, such as Groceries.
AmountcostnumberRequired
How much it cost, such as 48.60.At least 0.01.
Groupgrouptext
The group to split it in, equally. Or pick a friend instead.
Friendfriendtext
Instead of a group, the friend to split it with, half each.
Paid bypaid_bytext
With a friend, who paid. Defaults to you.One of: me (I paid), friend (My friend paid). Default: me.
Currencycurrency_codetext
Its currency, such as EUR. Defaults to your default currency.
Datedatedate
When it was spent. Defaults to today.
Notesdetailstext
Notes about it.
Repeatsrepeattext
How often Splitwise adds it again. Defaults to never.One of: never (Doesn't repeat), weekly (Every week), fortnightly (Every two weeks), monthly (Every month), yearly (Every year). Default: never.

Outputs

categorytext
Its category, such as Groceries
costnumber
How much it cost
created_attext
When it was added (ISO 8601)
created_bytext
Who added it
currencytext
Its currency code, such as USD
datetext
When it was spent (ISO 8601)
deletedtrue/false
True if it was deleted
descriptiontext
What it was for
detailstext
Its notes
group_idnumber
Its group; 0 if it isn't in one
idnumber
The expense's number
is_paymenttrue/false
True if it records someone paying someone back
shareslist
Who paid and who owes what
updated_attext
When it last changed (ISO 8601)
you_paidnumber
How much you paid
your_sharenumber
How much of it is yours
Example output
{
  "category": "Groceries",
  "cost": 48.6,
  "created_at": "2026-10-28T12:01:00Z",
  "created_by": "Alex Kim",
  "currency": "USD",
  "date": "2026-10-28T12:00:00Z",
  "deleted": false,
  "description": "Groceries",
  "details": "",
  "group_id": 5512,
  "id": 3071209876,
  "is_payment": false,
  "shares": [
    {
      "name": "Alex Kim",
      "owes": 24.3,
      "paid": 48.6,
      "user_id": 101
    },
    {
      "name": "Sam Lee",
      "owes": 24.3,
      "paid": 0.0,
      "user_id": 102
    }
  ],
  "updated_at": "2026-10-28T12:01:00Z",
  "you_paid": 48.6,
  "your_share": 24.3
}

Change expense

Change an expense's description, amount, date or notes. A new amount is split as before.

Inputs

ExpenseexpensetextRequired
The expense's number, from 'Add expense', 'List expenses' or the trigger.
Descriptiondescriptiontext
A new description. Leave empty to keep it.
Amountcostnumber
A new amount. Leave empty to keep it.At least 0.01.
Datedatedate
A new date. Leave empty to keep it.
Notesdetailstext
New notes. Leave empty to keep them.

Outputs

categorytext
Its category, such as Groceries
costnumber
How much it cost
created_attext
When it was added (ISO 8601)
created_bytext
Who added it
currencytext
Its currency code, such as USD
datetext
When it was spent (ISO 8601)
deletedtrue/false
True if it was deleted
descriptiontext
What it was for
detailstext
Its notes
group_idnumber
Its group; 0 if it isn't in one
idnumber
The expense's number
is_paymenttrue/false
True if it records someone paying someone back
shareslist
Who paid and who owes what
updated_attext
When it last changed (ISO 8601)
you_paidnumber
How much you paid
your_sharenumber
How much of it is yours
Example output
{
  "category": "Groceries",
  "cost": 48.6,
  "created_at": "2026-10-28T12:01:00Z",
  "created_by": "Alex Kim",
  "currency": "USD",
  "date": "2026-10-28T12:00:00Z",
  "deleted": false,
  "description": "Groceries",
  "details": "",
  "group_id": 5512,
  "id": 3071209876,
  "is_payment": false,
  "shares": [
    {
      "name": "Alex Kim",
      "owes": 24.3,
      "paid": 48.6,
      "user_id": 101
    },
    {
      "name": "Sam Lee",
      "owes": 24.3,
      "paid": 0.0,
      "user_id": 102
    }
  ],
  "updated_at": "2026-10-28T12:01:00Z",
  "you_paid": 48.6,
  "your_share": 24.3
}

Comment on expense

Add a comment to an expense, which everyone on it sees.

Inputs

ExpenseexpensetextRequired
The expense's number, from 'Add expense', 'List expenses' or the trigger.
CommentcontenttextRequired
What to say.

Outputs

contenttext
What it says
expense_idnumber
The expense
idnumber
The comment's number
Example output
{
  "content": "Receipt is in the shared folder",
  "expense_id": 3071209876,
  "id": 88001
}

Create group

Make a group with just you in it, such as for a trip or a household. Add people in Splitwise.

Inputs

NamenametextRequired
What to call it, such as Lisbon trip.
Typegroup_typetext
What it's for. Defaults to other.One of: trip, home, couple, other. Default: other.

Outputs

debtslist
Who owes whom, simplified
idnumber
The group's number
memberslist
Its members
nametext
Its name
typetext
trip, home, couple or other
updated_attext
When it last changed (ISO 8601)
Example output
{
  "debts": [],
  "id": 5512,
  "members": [
    {
      "id": 101,
      "name": "Alex Kim"
    }
  ],
  "name": "Flat 4B",
  "type": "home",
  "updated_at": "2026-10-28T12:01:00Z"
}

Delete expense

Delete an expense. 'Restore expense' brings it back.

Inputs

ExpenseexpensetextRequired
The expense's number, from 'Add expense', 'List expenses' or the trigger.

Outputs

deletedtrue/false
True once deleted
idnumber
The expense's number
Example output
{
  "deleted": true,
  "id": 3071209876
}

Delete group

Delete a group and its expenses. Splitwise's website can restore it.

Inputs

GroupgrouptextRequired
The group to delete.

Outputs

deletedtrue/false
True once deleted
idnumber
The group's number
Example output
{
  "deleted": true,
  "id": 5512
}

Get expense

Get one expense: its cost, who paid and who owes what.

Inputs

ExpenseexpensetextRequired
The expense's number, from 'Add expense', 'List expenses' or the trigger.

Outputs

categorytext
Its category, such as Groceries
costnumber
How much it cost
created_attext
When it was added (ISO 8601)
created_bytext
Who added it
currencytext
Its currency code, such as USD
datetext
When it was spent (ISO 8601)
deletedtrue/false
True if it was deleted
descriptiontext
What it was for
detailstext
Its notes
group_idnumber
Its group; 0 if it isn't in one
idnumber
The expense's number
is_paymenttrue/false
True if it records someone paying someone back
shareslist
Who paid and who owes what
updated_attext
When it last changed (ISO 8601)
you_paidnumber
How much you paid
your_sharenumber
How much of it is yours
Example output
{
  "category": "Groceries",
  "cost": 48.6,
  "created_at": "2026-10-28T12:01:00Z",
  "created_by": "Alex Kim",
  "currency": "USD",
  "date": "2026-10-28T12:00:00Z",
  "deleted": false,
  "description": "Groceries",
  "details": "",
  "group_id": 5512,
  "id": 3071209876,
  "is_payment": false,
  "shares": [
    {
      "name": "Alex Kim",
      "owes": 24.3,
      "paid": 48.6,
      "user_id": 101
    },
    {
      "name": "Sam Lee",
      "owes": 24.3,
      "paid": 0.0,
      "user_id": 102
    }
  ],
  "updated_at": "2026-10-28T12:01:00Z",
  "you_paid": 48.6,
  "your_share": 24.3
}

Get group

Get one group: its members and who owes whom.

Inputs

GroupgrouptextRequired
The group.

Outputs

debtslist
Who owes whom, simplified
idnumber
The group's number
memberslist
Its members
nametext
Its name
typetext
trip, home, couple or other
updated_attext
When it last changed (ISO 8601)
Example output
{
  "debts": [
    {
      "amount": 24.3,
      "currency": "USD",
      "from": "Sam Lee",
      "to": "Alex Kim"
    }
  ],
  "id": 5512,
  "members": [
    {
      "id": 101,
      "name": "Alex Kim"
    },
    {
      "id": 102,
      "name": "Sam Lee"
    }
  ],
  "name": "Flat 4B",
  "type": "home",
  "updated_at": "2026-10-28T12:01:00Z"
}

Get my account

Get your Splitwise name, email and default currency.

Inputs

None.

Outputs

default_currencytext
Your default currency
emailtext
Your email address
idnumber
Your user number
nametext
Your name
Example output
{
  "default_currency": "USD",
  "email": "alex@example.com",
  "id": 101,
  "name": "Alex Kim"
}

List comments

List an expense's comments, oldest first, including the ones Splitwise adds when it changes.

Inputs

ExpenseexpensetextRequired
The expense's number, from 'Add expense', 'List expenses' or the trigger.

Outputs

commentslist
The comments, oldest first
countnumber
How many
expense_idnumber
The expense
Example output
{
  "comments": [
    {
      "by": "Alex Kim",
      "content": "Receipt is in the shared folder",
      "created_at": "2026-10-28T12:05:00Z",
      "from_splitwise": false,
      "id": 88001
    }
  ],
  "count": 1,
  "expense_id": 3071209876
}

List expenses

List expenses, newest first, in a group or with a friend, between two dates.

Inputs

Groupgrouptext
Only this group's expenses.
Friendfriendtext
Only expenses with this friend.
Fromdated_afterdate
Only expenses on or after this day.
Untildated_beforedate
Only expenses on or before this day.
How manylimitnumber
How many expenses. Defaults to 20.From 1 to 500.

Outputs

countnumber
How many
expenseslist
The expenses
Example output
{
  "count": 1,
  "expenses": [
    {
      "category": "Groceries",
      "cost": 48.6,
      "created_at": "2026-10-28T12:01:00Z",
      "created_by": "Alex Kim",
      "currency": "USD",
      "date": "2026-10-28T12:00:00Z",
      "deleted": false,
      "description": "Groceries",
      "details": "",
      "group_id": 5512,
      "id": 3071209876,
      "is_payment": false,
      "shares": [
        {
          "name": "Alex Kim",
          "owes": 24.3,
          "paid": 48.6,
          "user_id": 101
        },
        {
          "name": "Sam Lee",
          "owes": 24.3,
          "paid": 0.0,
          "user_id": 102
        }
      ],
      "updated_at": "2026-10-28T12:01:00Z",
      "you_paid": 48.6,
      "your_share": 24.3
    }
  ]
}

List friends

List your friends, with what each owes you (positive) or you owe them (negative).

Inputs

None.

Outputs

countnumber
How many
friendslist
Your friends
Example output
{
  "count": 1,
  "friends": [
    {
      "balances": [
        {
          "amount": 24.3,
          "currency": "USD"
        }
      ],
      "email": "sam@example.com",
      "id": 102,
      "name": "Sam Lee",
      "settled_up": false
    }
  ]
}

List groups

List your groups, with who owes whom in each.

Inputs

None.

Outputs

countnumber
How many
groupslist
Your groups
Example output
{
  "count": 1,
  "groups": [
    {
      "debts": [
        {
          "amount": 24.3,
          "currency": "USD",
          "from": "Sam Lee",
          "to": "Alex Kim"
        }
      ],
      "id": 5512,
      "members": [
        {
          "id": 101,
          "name": "Alex Kim"
        },
        {
          "id": 102,
          "name": "Sam Lee"
        }
      ],
      "name": "Flat 4B",
      "type": "home",
      "updated_at": "2026-10-28T12:01:00Z"
    }
  ]
}

Restore expense

Bring back a deleted expense.

Inputs

ExpenseexpensetextRequired
The expense's number, from 'Add expense', 'List expenses' or the trigger.

Outputs

categorytext
Its category, such as Groceries
costnumber
How much it cost
created_attext
When it was added (ISO 8601)
created_bytext
Who added it
currencytext
Its currency code, such as USD
datetext
When it was spent (ISO 8601)
deletedtrue/false
True if it was deleted
descriptiontext
What it was for
detailstext
Its notes
group_idnumber
Its group; 0 if it isn't in one
idnumber
The expense's number
is_paymenttrue/false
True if it records someone paying someone back
shareslist
Who paid and who owes what
updated_attext
When it last changed (ISO 8601)
you_paidnumber
How much you paid
your_sharenumber
How much of it is yours
Example output
{
  "category": "Groceries",
  "cost": 48.6,
  "created_at": "2026-10-28T12:01:00Z",
  "created_by": "Alex Kim",
  "currency": "USD",
  "date": "2026-10-28T12:00:00Z",
  "deleted": false,
  "description": "Groceries",
  "details": "",
  "group_id": 5512,
  "id": 3071209876,
  "is_payment": false,
  "shares": [
    {
      "name": "Alex Kim",
      "owes": 24.3,
      "paid": 48.6,
      "user_id": 101
    },
    {
      "name": "Sam Lee",
      "owes": 24.3,
      "paid": 0.0,
      "user_id": 102
    }
  ],
  "updated_at": "2026-10-28T12:01:00Z",
  "you_paid": 48.6,
  "your_share": 24.3
}

On this page