🤝 Debts
Track money you owe and money owed to you, partial payments, close debts.
- i_owe - Money you owe to someone
- owe_me - Money someone owes to you
On this page
create_debt
SafeCreate a new debt record. Specify if you borrowed money (i_owe) or lent money (owe_me). Optionally set a due date for reminders.
Parameters
| Parameter | Type | Description |
|---|---|---|
| type* | string | "i_owe" (I borrowed) or "owe_me" (I lent) |
| contact_name* | string | Name of person |
| amount* | number | Debt amount |
| currency? | string | Currency code. Default: RUB |
| description? | string | What for |
| due_date? | string | When to return. Supports: dates, "by Feb 15", "in 3 days" |
| reminder_days? | number | Days before due_date to send reminder. Default: 3 |
| notes? | string | Additional notes about the debt |
Examples
list_debts
SafeShow all active debts, grouped by type (what you owe and what's owed to you).
Parameters
| Parameter | Type | Description |
|---|---|---|
| type? | string | Filter: "i_owe" or "owe_me" |
| include_closed? | boolean | Include closed debts. Default: false |
Examples
You owe (2):
• Pete: $5,000
• Bank: $50,000
Owed to you (1):
• Mike: $3,000 (due 01/24)
pay_debt
SafeRecord a payment toward a debt you owe. Supports partial payments. Optionally creates an expense transaction.
Parameters
| Parameter | Type | Description |
|---|---|---|
| contact_name* | string | Who you're paying |
| amount* | number | Payment amount |
| wallet? | string | Wallet to pay from (creates expense) |
Examples
receive_debt
SafeRecord receiving payment for a debt owed to you. Optionally creates an income transaction.
Parameters
| Parameter | Type | Description |
|---|---|---|
| contact_name* | string | Who is paying |
| amount* | number | Received amount |
| wallet? | string | Wallet to receive to (creates income) |
Examples
close_debt
Requires ConfirmationClose a debt and automatically create a linked transaction. Creates income (if someone returned money to you) or expense (if you returned money).
When closing a debt, a transaction is automatically created:
- owe_me (someone owed you) → Creates income transaction
- i_owe (you owed someone) → Creates expense transaction
Parameters
| Parameter | Type | Description |
|---|---|---|
| contact_name* | string | Person's name (or comma-separated list) |
| wallet? | string | Wallet for the linked transaction. Default: user's default wallet |
Examples
edit_debt
SafeEdit debt details: amount, due date, or description.
Parameters
| Parameter | Type | Description |
|---|---|---|
| contact_name* | string | Person's name |
| amount? | number | New amount |
| due_date? | string | New due date |
| description? | string | New description |