dimesumdevelopers API reference Console Open the app

Your shared expenses, from anywhere you already are

The Dimesum API lets a script, a spreadsheet, a phone shortcut or an assistant do what you do in the app: read your groups, bills and balances, add a bill, comment on one, record a payment. A key acts as you and sees exactly what you see.

Three things people automate first#

What you can do#

  • Read everything you can see in the app: your groups and their members, every bill with its split and history, comments, balances per currency, payments, repeats, activity and spending insights.
  • Write the everyday things: add, edit and delete bills (the edit restates the whole split, so nothing changes by accident), comment, record a payment you made elsewhere, set up rent or a subscription as a repeat, add a kept place for someone without an account.
  • Capture from text: send a line such as "dinner 1200 with Ravi and Priya, I paid" and get a draft back that a person confirms.
  • Talk to it: the MCP server exposes 14 tools to Claude and other assistants over the same rules.

40 operations in all, each listed in the API reference and callable from the console. Some things are deliberately out of reach of a key, such as your sign-in methods, payment details and the keys themselves; Authentication says which and why.

The 60-second quickstart#

Make a key in the app under Me › Profile › Developer, then:

curl
# 1. Keep the key out of your shell history and out of git
export DIMESUM_API_KEY="dms_live_..."

# 2. Who am I?
curl https://api.dimesum.com/v1/me -H "Authorization: Bearer $DIMESUM_API_KEY"

# 3. My groups, with where I stand in each
curl https://api.dimesum.com/v1/groups -H "Authorization: Bearer $DIMESUM_API_KEY"

# 4. Add a ₹1,200 dinner, split equally, paid by me (needs a read and write key)
GROUP_ID="paste a group id from step 3"
curl https://api.dimesum.com/v1/groups/$GROUP_ID/expenses \
  -H "Authorization: Bearer $DIMESUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"id\": \"$(uuidgen)\", \"description\": \"Dinner\", \"amount_minor\": 120000}"

# 5. Where everyone stands now
curl https://api.dimesum.com/v1/groups/$GROUP_ID/balances -H "Authorization: Bearer $DIMESUM_API_KEY"

Two things in step 4 are worth knowing before you write more:

  • amount_minor is 120000 because money is always an integer in the currency's smallest unit: 120000 paise is ₹1,200.00. See Money.
  • id is a UUID you generate. It makes the write safe to retry: send the same request again and you get the same bill back, not a second one. See Idempotency.

The Quickstart walks the same path in curl, JavaScript and Python.

Base URLs#

EnvironmentBase URL
Productionhttps://api.dimesum.com
Local developmenthttp://localhost:8080

The contract is published as OpenAPI 3.1 at GET /v1/openapi.json on the API and as openapi.json on this site.

Dimesum never holds or moves money

Recording a payment says that money moved in your own bank or payment app. The person you paid confirms or disputes it. See Payments.