Python SDK: Expenses

Create an Expense

client.expenses.create(
    project_id="prj_abc",
    expense_category_id="cat_llm_usage",
    spent_date="2026-03-06",
    units=45,
    notes="claude-opus-4-6: 30k input + 15k output tokens",
    source="agent",
    metadata={
        "agent_id": "review-bot-01",
        "session_id": "550e8400-e29b-41d4-a716-446655440000",
        "model": "claude-opus-4-6",
        "input_tokens": 30000,
        "output_tokens": 15000,
    },
)

List Expenses

expenses = client.expenses.list(
    source="agent",
    project_id="prj_abc",
    from_date="2026-03-01",
)

for expense in expenses.data:
    print(f"{expense.spent_date}: {expense.units} units — {expense.notes}")

Get a Single Expense

expense = client.expenses.get("exp_xyz789")
print(f"Total cost: {expense.total_cost}")