Partners

Settle Split

Mark a bill split as squared up between the two of you.

Settling is a bookkeeping fact, not a movement of money. earmarkIQ cannot make a transfer between two people's banks and cannot reliably observe one, so the only thing it can honestly record is that the two of you consider this settled — which removes the row from the outstanding balance and nothing else.

It deliberately does NOT touch budget spend: _calculate_partner_spend sums what each person actually spent, and a transfer between partners is not spending by either of them. Matching a settlement to a real bank transfer would need partner-to-partner transfer detection and is a separate piece of work.

put/api/partners/splits/{split_id}/settle

Request

  • Base URL: https://api.earmarkiq.app (the document declares no server; this is the origin it was published from)
  • URL: https://api.earmarkiq.app/api/partners/splits/{split_id}/settle
  • Auth: HTTP bearer

Path parameters

split_idstring uuid required

Response

Successful Response

idstring required
descriptionstring required
total_amountnumber required
split_typestring required
user1_sharenumber required
user2_sharenumber required
settledboolean required
created_atstring required
settled_atstring nullable required
you_paidboolean nullable required
your_sharenumber required
their_sharenumber required
transaction_idstring nullable required

Changes

No recorded changes to this operation across all 2 revisions of this API.