---
title: "List Expenses"
method: GET
path: "/billing/org/v1/expenses"
tags: ["expenses"]
---

# List Expenses

`GET /billing/org/v1/expenses`

Retrieve a list of `Expense` objects.

You can use query parameters to filter, sort, and paginate the results.


You can set the `money_decimals` query parameter to specify the number of decimal places for money fields.

Examples:

- `?money_decimals=2` will return money values rounded to 2 decimal places.
- `?money_decimals=max` will return money values with the maximum precision.

## Query parameters

- `addendum_id` integer[]
- `calc_rule_type` string[]
- `client_id` integer[]
- `comment` string
- `company_name` string
- `created_after` string, date-time
- `created_before` string, date-time
- `created_on` string, date
- `currency_char_code` string[]
- `currency_id` integer[]
- `deleted` boolean
- `description` string
- `discount_id` integer[]
- `feature_id` integer[]
- `feature_name` string
- `for_date` string, date-time
- `for_date_after` string, date-time
- `for_date_before` string, date-time
- `id` integer
- `invoice_id` integer[]
- `invoice_item_id` integer[]
- `limit` integer
- `metric_ext_name` string
- `metric_id` integer[]
- `money_value` number
- `money_value__from` number
- `money_value__to` number
- `offset` integer
- `ordering` string[]
- `payer_id` integer[]
- `period_contains` string, date-time
- `period_ends_before` string, date-time
- `period_outside` string, date-time
- `period_starts_after` string, date-time
- `plan_id` integer[]
- `plan_name` string
- `product_category_id` integer[]
- `product_category_name` string
- `product_id` integer[]
- `product_internal_name` string[]
- `product_name` string
- `region_id` integer[]
- `region_int_name` string[]
- `region_name` string
- `subscription_id` integer[]
- `tax_rate` number

## Response `200`

Request successful.

- PaginatedExpenseForOrgSerializerV1List
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` ExpenseForOrgSerializerV1[], required
    - `id` integer, required
    - `client_id` string, required — The ID of the client associated with the expense.
    - `payer_id` string, required — The ID of the payer associated with the expense.
    - `client` CustomerPayerCommonShort, required
      - `id` integer, required
      - `company_name` string, required
    - `comment` string, nullable, required — Public comment
    - `for_date` string, date-time, required — Date of expense
    - `period_range` DateTimeTZRange, required — Date-time range with start and end fields.
      - `start` string, date-time, nullable
      - `end` string, date-time, nullable
    - `calc_rule_type` string, required — Type of the calculation rule applied to the expense.
    - `currency` CurrencyCommonShort, required
      - `id` integer, required
      - `char_code` string, required — Currency iso4217 char code
      - `symbol` string, nullable — Currency symbol, for example '$'
    - `money_value` string, decimal, required — The monetary value of the expense.
    - `tax_value` string, decimal, required — The monetary value of the tax applied to the expense.
    - `tax_rate` string, decimal, required — The tax rate applied to the expense.
    - `usage` Usage, required — Resolve a Unit from an Expense via `plan_item` or subscription.`price_json`.
      - `amount` string, decimal, required — The amount of usage
      - `unit_name` string, nullable, required — The name of the unit of measurement for the usage
    - `metric_ext_name` string, required — Metric code of the feature associated with the expense.
    - `region` StatisticRegionCommonShort, required
      - `id` integer, required
      - `name` string, required
      - `external_name` string, required
    - `discount_value` string, decimal, required — The monetary value of the discount applied to the expense.
    - `discount` DiscountCommonShort, required
      - `id` integer, required
      - `relative_value` string, decimal, required
      - `comment` string, nullable — Public comment
    - `deleted` boolean, required — Indicates whether the expense has been deleted.
    - `description` string, required — Description of the expense.
    - `product_category` ProductCategoryCommonShort, required
      - `id` integer, required
      - `name` string, required
    - `product` ProductCommonShort, required
      - `id` integer, required
      - `name` string, required
      - `internal_name` string, required
    - `addendum` AddendumCommonShort, required
      - `id` integer, required
      - `active_range` DateTimeTZRange, required — Date-time range with start and end fields.
        - `start` string, date-time, nullable
        - `end` string, date-time, nullable
      - `status` 'upcoming' | 'active' | 'paused' | 'stopped' — Addendum status - `upcoming` - upcoming - `active` - active - `paused` - paused - `stopped` - stopped
    - `plan` PlanCommonShort, required
      - `id` integer, required
      - `name` string, required
    - `feature` FeatureCommonShort, required
      - `id` integer, required
      - `name` string, required
      - `erp_sku_id` string, nullable, required
    - `subscription` string, required — The subscription associated with the expense.
    - `plan_item` AdminPlanItemCommonShort, required
      - `id` integer, required
      - `default` boolean, required
      - `comment` string, nullable — Public comment
      - `description` string, nullable — Description for internal use
    - `invoices` InvoiceItemIDsShort[], required — List of invoice item IDs associated with the expense.
      - `invoice_id` integer, required
      - `invoice_date` string, date, required
      - `invoice_item_id` integer, required

## Other responses

- `401` — Authentication credentials were not provided or are invalid.
- `403` — You do not have permission to perform this action.

---

[API](https://skmtc.dev/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.dev/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)