Skip to main content

​
yc-bench finance-ledger

Display a detailed ledger of all financial transactions including payments received, salaries paid, and other expenses.

​
Usage

yc-bench finance-ledger [OPTIONS]

​
Parameters

​
--type
string
Filter by transaction type: income, expense, payroll, task_payment
​
--start-date
string
Filter transactions after this date (ISO 8601 format)
​
--end-date
string
Filter transactions before this date (ISO 8601 format)
​
--limit
number
Maximum number of transactions to return (default: 50)

​
Response

Returns transaction history:
​
transactions
array
List of financial transactions
​
transactions[].id
string
Unique transaction identifier
​
transactions[].date
string
Transaction date (ISO 8601 format)
​
transactions[].type
string
Transaction type: income, expense, payroll, task_payment, etc.
​
transactions[].description
string
Human-readable description
​
transactions[].amount
number
Transaction amount (positive for income, negative for expenses)
​
transactions[].balance
number
Account balance after transaction
​
transactions[].relatedEntity
string | null
Related task ID, employee ID, or null
​
totalIncome
number
Sum of all income in period
​
totalExpenses
number
Sum of all expenses in period
​
netCashFlow
number
Net change (income - expenses)
​
currentBalance
number
Current account balance

​
Example

# View all transactions
yc-bench finance-ledger

# View only income transactions
yc-bench finance-ledger --type income

# View transactions for specific date range
yc-bench finance-ledger --start-date 2024-01-01 --end-date 2024-01-31
Example Output
{
  "transactions": [
    {
      "id": "txn_001",
      "date": "2024-01-01T00:00:00.000Z",
      "type": "income",
      "description": "Initial funding",
      "amount": 50000,
      "balance": 50000,
      "relatedEntity": null
    },
    {
      "id": "txn_002",
      "date": "2024-01-15T00:00:00.000Z",
      "type": "task_payment",
      "description": "Payment for: Fix authentication bugs",
      "amount": 3000,
      "balance": 53000,
      "relatedEntity": "task_123"
    },
    {
      "id": "txn_003",
      "date": "2024-02-01T00:00:00.000Z",
      "type": "payroll",
      "description": "Monthly payroll - 3 employees",
      "amount": -18000,
      "balance": 35000,
      "relatedEntity": null
    },
    {
      "id": "txn_004",
      "date": "2024-02-10T00:00:00.000Z",
      "type": "task_payment",
      "description": "Payment for: Build React dashboard",
      "amount": 8000,
      "balance": 43000,
      "relatedEntity": "task_124"
    }
  ],
  "totalIncome": 61000,
  "totalExpenses": -18000,
  "netCashFlow": 43000,
  "currentBalance": 43000
}

​
Transaction Types

  • income - General income (initial funding, grants, etc.)
  • task_payment - Payment received for completed task
  • payroll - Monthly employee salary payments
  • expense - Other business expenses
  • hiring_cost - Employee hiring/recruitment costs

Build docs developers (and LLMs) love

Get started for freeTalk to us