Skip to main content
GET
/
billing
/
org
/
v1
/
expenses
List Expenses
curl --request GET \
  --url https://api.gcore.com/billing/org/v1/expenses \
  --header 'Authorization: <api-key>'
{
  "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"
      },
      "calc_rule_type": "<string>",
      "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"
        },
        "status": "upcoming"
      },
      "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
  • unit - unit
  • post_invoice - post_invoice
Available options:
commit,
overcommit,
post_invoice,
staged,
stepped,
unit
​
client_id
(integer | null)[]

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.

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

​
ordering
enum<string>[]

Ordering of the results.

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.

  • 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 - Shield Proxy
  • 32 - AI Managed Dedicated Compute
​
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
  • 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 - Shield 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
​
count
integer
required
Example:

123

​
results
object[]
required
​
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"