List 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.

GET /billing/org/v1/expenses

List Expenses

cURL

curl --request GET \
  --url https://api.gcore.com/billing/org/v1/expenses \
  --header 'Authorization: <api-key>'

200

{
  "count": 123,
  "results": [
    {
      "id": 123,
      "client_id": 123,
      "payer_id": 123,
      "client": {
        "id": 123,
        "company_name": "<string>"
      },
      "comment": "<string>",
      "for_date": "2023-11-07T05:31:56Z",
      "period_range": {
        "start": "2023-11-07T05:31:56Z",
        "end": "2023-11-07T05:31:56Z"
      },
      "currency": {
        "id": 123,
        "char_code": "<string>",
        "symbol": "<string>"
      },
      "money_value": "<string>",
      "tax_value": "<string>",
      "tax_rate": "<string>",
      "usage": {
        "amount": "<string>",
        "unit_name": "<string>"
      },
      "metric_ext_name": "<string>",
      "region": {
        "id": 123,
        "name": "<string>",
        "external_name": "<string>"
      },
      "discount_value": "<string>",
      "discount": {
        "id": 123,
        "relative_value": "<string>",
        "comment": "<string>"
      },
      "deleted": true,
      "description": "<string>",
      "product_category": {
        "id": 123,
        "name": "<string>"
      },
      "product": {
        "id": 123,
        "name": "<string>",
        "internal_name": "<string>"
      },
      "addendum": {
        "id": 123,
        "active_range": {
          "start": "2023-11-07T05:31:56Z",
          "end": "2023-11-07T05:31:56Z"
        }
      },
      "plan": {
        "id": 123,
        "name": "<string>"
      },
      "feature": {
        "id": 123,
        "name": "<string>",
        "erp_sku_id": "<string>"
      },
      "subscription": "<string>",
      "plan_item": {
        "id": 123,
        "default": true,
        "comment": "<string>",
        "description": "<string>"
      },
      "invoices": [
        {
          "invoice_id": 123,
          "invoice_date": "2023-12-25",
          "invoice_item_id": 123
        }
      ]
    }
  ],
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100"
}

Authorizations

Authorization · string · header · required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234_abcdef

Query Parameters

addendum_id · (integer | null)[]

Filter by Addendum ID. Can be multiple.

calc_rule_type · enum<string>[]

Filter by calculation rule type. Can be multiple.

• commit - commit
• overcommit - overcommit
• stepped - stepped
• staged - staged
• commit_hourly - commit_hourly

Available options: commit, commit_hourly, overcommit, staged, stepped

client_id · integer[]

Filter by client ID. Can be multiple.

Required range: -2147483648 <= x <= 2147483647

comment · string

company_name · string

Filter by client's company name (client's name). Case insensitive. Supports partial matches.

created_after · string<date-time>

Filter by creation date-time.

Returns items created after the specified date-time (ISO 8601/RFC 3339 format, UTC.)

You can specify a date with a time separated by a space, or just a date.

Examples:

• &created_after=2025-05-15
• &created_after=2025-05-15 12:00:00
• &created_after=2025-05-15T12:00:00Z

created_before · string<date-time>

Filter by creation date-time.

Returns items created before the specified date-time (ISO 8601/RFC 3339 format, UTC.)

You can specify a date with a time separated by a space, or just a date.

Examples:

• &created_before=2025-05-15
• &created_before=2025-05-15 12:00:00
• &created_before=2025-05-15T12:00:00Z

created_on · string<date>

currency_char_code · string[]

Filter by currency char code (e.g. USD, EUR). Can be multiple.

Returns currencies with the specified char code.

Examples:

• &currency_char_code=USD
• &currency_char_codeEUR&currency_char_codeUSD

Available values:

• EUR - Euro
• USD - US Dollar

currency_id · integer[]

Filter by currency ID. Can be multiple.

Returns currencies with the specified ID.

Examples:

• &currency_id=1
• &currency_id=1&currency_id=2

Available values:

• 1 - US Dollar
• 2 - Euro

deleted · boolean

Filter by deleted status.

Returns items based on their deletion status.

• true - only deleted items
• false - only non-deleted items
• none - all items (default)

description · string

discount_id · (integer | null)[]

Filter by Discount ID. Can be multiple.

feature_id · (integer | null)[]

Filter by feature ID. Can be multiple.

feature_name · string

Filter by feature name. Case insensitive. Supports partial matches.

for_date · string<date-time>

Filter by date.

Returns items for the specified date (ISO 8601 format, UTC.)

Examples:

• &for_date=2025-05-15

for_date_after · string<date-time>

Filter by date.

Returns items after and including the specified date (ISO 8601 format, UTC.)

Examples:

• &for_date_after=2025-05-15

for_date_before · string<date-time>

Filter by date.

Returns items on or before the specified date (ISO 8601 format, UTC.)

Examples:

• &for_date_before=2025-05-15

id · integer

invoice_id · integer[]

invoice_item_id · integer[]

limit · integer

Number of results to return per page. Maximum is 100. Default is 20.

metric_ext_name · string

Filter by metric code. Case-insensitive. Supports partial matches.

metric_id · integer[]

Filter by metric ID. Can be multiple.

money_value · number

money_value__from · number

money_value__to · number

offset · integer

The initial index from which to return the results.

order_by · enum<string>[]

Ordering of the results.

For ascending sort order use field.asc, for descending sort order use field.desc.

For sorting by multiple parameters write them as comma separated string: client_id.asc,id.desc.

Final stable tiebreak ordering is added except when pk sorting used.

• addendum_id.asc - Addendum id
• addendum_id.desc - Addendum id (descending)
• period_range_start.asc - Period range start
• period_range_start.desc - Period range start (descending)
• period_range_end.asc - Period range end
• period_range_end.desc - Period range end (descending)
• calc_rule_type.asc - Calc rule type
• calc_rule_type.desc - Calc rule type (descending)
• created_at.asc - Created at
• created_at.desc - Created at (descending)
• currency_id.asc - Currency id
• currency_id.desc - Currency id (descending)
• feature_name.asc - Feature name
• feature_name.desc - Feature name (descending)
• for_date.asc - For date
• for_date.desc - For date (descending)
• id.asc - Id
• id.desc - Id (descending)
• money_value.asc - Money value
• money_value.desc - Money value (descending)
• plan_item_id.asc - Plan item id
• plan_item_id.desc - Plan item id (descending)
• product_name.asc - Product name
• product_name.desc - Product name (descending)
• product_id.asc - Product id
• product_id.desc - Product id (descending)
• tax_rate.asc - Tax rate
• tax_rate.desc - Tax rate (descending)
• region_id.asc - Region id
• region_id.desc - Region id (descending)
• region_name.asc - Region name
• region_name.desc - Region name (descending)

Available options: addendum_id.asc, addendum_id.desc, calc_rule_type.asc, calc_rule_type.desc, created_at.asc, created_at.desc, currency_id.asc, currency_id.desc, feature_name.asc, feature_name.desc, for_date.asc, for_date.desc, id.asc, id.desc, money_value.asc, money_value.desc, period_range_end.asc, period_range_end.desc, period_range_start.asc, period_range_start.desc, plan_item_id.asc, plan_item_id.desc, product_id.asc, product_id.desc, product_name.asc, product_name.desc, region_id.asc, region_id.desc, region_name.asc, region_name.desc, tax_rate.asc, tax_rate.desc

ordering · enum<string>[]

Ordering of the results.

This field is left for compatibility and can be deprecated in future versions. Use order_by instead.

Default sort order is ascending. Put - before value for descending sort order: -id.

For sorting by multiple parameters write them as comma separated string: -client_id,id.

Final stable tiebreak ordering is added except when pk sorting used.

• addendum_id - Addendum id
• -addendum_id - Addendum id (descending)
• period_range_start - Period range start
• -period_range_start - Period range start (descending)
• period_range_end - Period range end
• -period_range_end - Period range end (descending)
• calc_rule_type - Calc rule type
• -calc_rule_type - Calc rule type (descending)
• created_at - Created at
• -created_at - Created at (descending)
• currency_id - Currency id
• -currency_id - Currency id (descending)
• feature_name - Feature name
• -feature_name - Feature name (descending)
• for_date - For date
• -for_date - For date (descending)
• id - Id
• -id - Id (descending)
• money_value - Money value
• -money_value - Money value (descending)
• plan_item_id - Plan item id
• -plan_item_id - Plan item id (descending)
• product_name - Product name
• -product_name - Product name (descending)
• product_id - Product id
• -product_id - Product id (descending)
• tax_rate - Tax rate
• -tax_rate - Tax rate (descending)
• region_id - Region id
• -region_id - Region id (descending)
• region_name - Region name
• -region_name - Region name (descending)

Available options: -addendum_id, -calc_rule_type, -created_at, -currency_id, -feature_name, -for_date, -id, -money_value, -period_range_end, -period_range_start, -plan_item_id, -product_id, -product_name, -region_id, -region_name, -tax_rate, addendum_id, calc_rule_type, created_at, currency_id, feature_name, for_date, id, money_value, period_range_end, period_range_start, plan_item_id, product_id, product_name, region_id, region_name, tax_rate

payer_id · integer[]

Filter by payer ID. Can be multiple.

period_contains · string<date-time>

Filter by period range.

Returns items with a period containing the specified date-time (ISO 8601/RFC 3339 format, UTC.)

You can specify a date with a time separated by a space.

Examples:

• &period_contains=2025-05-15 12:00:00
• &period_contains=2025-05-15T12:00:00Z

period_ends_before · string<date-time>

Filter by period range.

Returns items with a period ending before the specified date-time (ISO 8601/RFC 3339 format, UTC.)

You can specify a date with a time separated by a space.

Examples:

• &period_ends_before=2025-05-15 12:00:00
• &period_ends_before=2025-05-15T12:00:00Z

period_outside · string<date-time>

Filter by period range.

Returns items excluding those with a period containing the specified date-time (ISO 8601/RFC 3339 format, UTC.)

You can specify a date with a time separated by a space.

Examples:

• &period_outside=2025-05-15 12:00:00
• &period_outside=2025-05-15T12:00:00Z

period_starts_after · string<date-time>

Filter by period range.

Returns items with a period beginning after the specified date-time (ISO 8601/RFC 3339 format, UTC.)

You can specify a date with a time separated by a space.

Examples:

• &period_starts_after=2025-05-15 12:00:00
• &period_starts_after=2025-05-15T12:00:00Z

plan_id · integer[]

Filter by plan ID. Can be multiple.

plan_name · string

Filter by plan name. Case insensitive. Supports partial matches.

product_category_id · integer[]

Filter by Product Category ID. Can be multiple.

product_category_name · string

Filter by product category name. Case insensitive. Supports partial matches.

product_id · integer[]

Filter by product ID. Can be multiple.

Returns products with the specified ID.

Examples:

• &product_id=1
• &product_id=1&product_id=2

Available values:

• 1 - CDN
• 2 - Object Storage
• 3 - Web Security
• 4 - Streaming
• 5 - Cloud
• 6 - Colocation Services
• 7 - WG Private Cloud
• 8 - p2p
• 9 - DDoS Protection
• 10 - Managed DNS
• 11 - Other Services
• 12 - Premium Support
• 13 - Connectivity
• 14 - Hosting (G-Hosting)
• 15 - Managed Services
• 16 - Rent
• 17 - Software development
• 18 - VM Ware
• 19 - LaaS
• 20 - AWS Cloud
• 21 - FastEdge
• 22 - Technical Support
• 23 - WAAP
• 25 - Edge Proxy
• 32 - AI Managed Dedicated Compute
• 65 - Gclaw

product_internal_name · string[]

Filter by product internal name. Can be multiple.

Returns products with the specified internal name.

Examples:

• &product_internal_name=CDN
• &product_internal_name=CDN&product_internal_name=DNS

Available values:

• AI_DEDCOMP - AI Managed Dedicated Compute
• AWS_CLOUD - AWS Cloud
• CDN - CDN
• CLOUD - Cloud
• CONNECT - Colocation Services
• CONNECTIVITY - Connectivity
• DDOS - Web Security
• DNS - Managed DNS
• FAST_EDGE - FastEdge
• GCLAW - Gclaw
• GHOST - Hosting (G-Hosting)
• INFRASTRUCTURE_PROTECTION - DDoS Protection
• LAAS - LaaS
• MANAGED_SERVICES - Managed Services
• OTHER_SERVICES - Other Services
• P2P - p2p
• PREMIUM_SUPPORT - Premium Support
• RENT - Rent
• SHIELD_PROXY - Edge Proxy
• SOFTWARE_DEVELOPMENT - Software development
• STORAGE - Object Storage
• STREAMING - Streaming
• TECHNICAL_SUPPORT - Technical Support
• VMWARE - VM Ware
• WAAP - WAAP
• WG_PRIVATE_CLOUD - WG Private Cloud

product_name · string

Filter by product name. Case insensitive. Supports partial matches.

region_id · integer[]

Filter by region ID. Can be multiple.

region_int_name · string[]

Filter by region internal name. Can be multiple.

region_name · string

Filter by region name. Case insensitive. Supports partial matches.

subscription_id · (integer | null)[]

Filter expenses by associated subscription IDs.

tax_rate · number

Response

200

application/json

Request successful.

count · integer · required

Example:

123

results · object[] · required

Show child attributes

next · string<uri> | null

Example:

"http://api.example.org/accounts/?offset=400&limit=100"

previous · string<uri> | null

Example:

"http://api.example.org/accounts/?offset=200&limit=100"