---
title: "Get Expenses"
method: GET
path: "/insights/v2/expenses"
tags: ["Expenses"]
---

# Get Expenses

`GET /insights/v2/expenses`

Provides insights on the expenses (outflows) from a bank account.

## Query parameters

- `entity_id` string, uuid, required
- `async` boolean
- `start_date` string, date
- `expense_type` 'CARD' | 'ALL'

## Response `200`

OK

- object
  - `insights` Expenses
    - `currency` string, required — The 3 Letter ISO code denominating the currency that the salary is provided in. This will be local currency (AED in UAE).
    - `total` ExpensesTotal, required
      - `count` integer — Number of expenses transactions within the time period.
      - `amount` number, required — Total expenses since start_date.
      - `first_date_time` string, date-time — UTC datetime of first expense transaction since start_date.
      - `last_date_time` string, date-time — UTC datetime of last expense transaction.
      - `average_monthly_count` number — Average number of expenses transactions per month since start_date.
      - `average_monthly_amount` number — Average expenses amount per month since start_date.
      - `minimum_monthly_amount` ExpensesMonthlyAmount
        - `month` integer — Number of month within the year (e.g.: January is represented as 1 and December is represented as 12)
        - `year` integer — Year
        - `amount` number, required — Total expenses for the month
      - `maximum_monthly_amount` ExpensesMonthlyAmount
        - `month` integer — Number of month within the year (e.g.: January is represented as 1 and December is represented as 12)
        - `year` integer — Year
        - `amount` number, required — Total expenses for the month
      - `breakdown` Breakdown[], required — Breakdown of expenses by category.
        - `by` string, required — Criteria by which we are breaking down the expenses.
        - `breakdowns` BreakdownElement[], required — List of breakdown elements.
          - union
            - CategoryMonthlyBreakdownElement
              - …
            - CategoryTotalBreakdownElement
              - …
    - `monthly_totals` MonthlyTotalExpenses[], required — Total expenses for all months from start_date until today.
      - `month` integer — Number of month within the year (e.g.: January is represented as 1 and December is represented as 12)
      - `year` integer — Year.
      - `amount` number, required — Total expenses for the month.
      - `count` integer — Number of expense transactions in the month.
      - `is_month_complete` boolean — Determines if Lean retrieved the data for all days for the month. This will always be `true`, except for the first and last month retrieved.
      - `breakdown` Breakdown[], required — Breakdown of expenses by category.
        - `by` string, required — Criteria by which we are breaking down the expenses.
        - `breakdowns` BreakdownElement[], required — List of breakdown elements.
          - union
            - CategoryMonthlyBreakdownElement
              - …
            - CategoryTotalBreakdownElement
              - …
    - `transactions` ExpensesTransaction[], required — List of expense transactions (internal use only, not serialized in API response)
      - `account_id` string, uuid, required — The account ID for the transaction
      - `transaction_id` string, required — The unique transaction identifier
      - `transaction_information` string, nullable — Additional information about the transaction
      - `booking_date_time` string, date-time, required — The date and time when the transaction was booked
      - `amount` number, required — The transaction amount
      - `category` string, required — The expense category
  - `type` 'income' | 'employment' | 'cashflow' | 'credits-obligations' | 'non-credits-obligations' | 'expenses' | 'cash-balances' | 'freelancer-cashflow' | 'behaviors' | 'cashflow-patterns' | 'credit-assessments' | 'account-controls' | 'credit-obligations' — type of insight

## Other responses

- `202` — Accepted (Asynchronous request)
- `400` — Bad Request
- `404` — Entity not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/leantech/apis/auth.md) · [All operations](https://skmtc.net/leantech/apis/auth/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leantech/auth/revisions/c2e46d54d886/schema)