Skip to main content
GET
/
billing
/
org
/
v1
/
subscriptions
List Subscriptions
curl --request GET \
  --url https://api.gcore.com/billing/org/v1/subscriptions \
  --header 'Authorization: <api-key>'
{
  "count": 123,
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100",
  "results": [
    {
      "id": 123,
      "client_id": 123,
      "client": {
        "id": 2,
        "company_name": "<string>"
      },
      "feature": {
        "id": 123,
        "name": "<string>",
        "erp_sku_id": "<string>"
      },
      "metric_ext_name": "<string>",
      "calc_rule_type": "<string>",
      "active_range": {
        "start": "2023-11-07T05:31:56Z",
        "end": "2023-11-07T05:31:56Z"
      },
      "price": "<string>",
      "product": {
        "id": 123,
        "name": "<string>",
        "internal_name": "<string>"
      },
      "product_category": {
        "id": 123,
        "name": "<string>"
      },
      "regions": [
        {
          "id": 123,
          "name": "<string>",
          "external_name": "<string>"
        }
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "comment": "<string>"
    }
  ]
}

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

​
active_after
string<date-time>

Filter by active period.

Returns items active 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:

* &active_after=2025-05-15 12:00:00

* &active_after=2025-05-15T12:00:00Z

​
active_at
string<date-time>

Filter by active period.

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

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

Examples:

* &active_at=2025-05-15 12:00:00

* &active_at=2025-05-15T12:00:00Z

​
active_before
string<date-time>

Filter by active period.

Returns items active 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:

* &active_before=2025-05-15 12:00:00

* &active_before=2025-05-15T12:00:00Z

​
active_end_from
string<date-time>

Filter by active period.

Returns items with the end of the active period on or after the specified date-time (ISO 8601/RFC 3339 format, UTC.)

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

Examples:

* &active_end_from=2025-05-15 12:00:00

* &active_end_from=2025-05-15T12:00:00Z

​
active_end_to
string<date-time>

Filter by active period.

Returns items with the end of the active period on or before the specified date-time (ISO 8601/RFC 3339 format, UTC.)

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

Examples:

* &active_end_to=2025-05-15 12:00:00

* &active_end_to=2025-05-15T12:00:00Z

​
active_start_from
string<date-time>

Filter by active period.

Returns items with the start of the active period on or after the specified date-time (ISO 8601/RFC 3339 format, UTC.)

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

Examples:

* &active_start_from=2025-05-15 12:00:00

* &active_start_from=2025-05-15T12:00:00Z

​
active_start_to
string<date-time>

Filter by active period.

Returns items with the start of the active period on or before the specified date-time (ISO 8601/RFC 3339 format, UTC.)

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

Examples:

* &active_start_to=2025-05-15 12:00:00

* &active_start_to=2025-05-15T12:00:00Z

​
calc_rule_type
(enum<string> | null)[]

Filter by calculation rule type. Can be multiple.

* commit - commit * overcommit - overcommit * stepped - stepped * staged - staged * unit - unit * post_invoice - post_invoice

​
client_id
(integer | null)[]

Filter by client ID. Can be multiple.

​
comment
string

Filter expenses by comment containing this value.

​
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>
​
description
string

Filter subscriptions by description containing this value.

​
feature_erp_sku_id
string

Filter by feature ERP SKU ID. Exact match.

​
feature_id
integer[]

Filter by feature ID. Can be multiple.

​
feature_name
string

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

​
id
integer
​
limit
integer

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

​
metric_ext_name
string[]

Filter by metric code. Can be multiple.

​
metric_id
integer[]

Filter by metric ID. Can be multiple.

​
not_active_at
string<date-time>

Filter by active period.

Returns items not active at the specified date-time (ISO 8601/RFC 3339 format, UTC.)

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

Examples:

* ¬_active_at=2025-05-15 12:00:00

* ¬_active_at=2025-05-15T12:00:00Z

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

* active_start - Active start * -active_start - Active start (descending) * active_end - Active end * -active_end - Active end (descending) * id - Id * -id - Id (descending) * client_id - Client id * -client_id - Client id (descending) * created_at - Created at * -created_at - Created at (descending) * feature_id - Feature id * -feature_id - Feature id (descending) * feature_name - Feature name * -feature_name - Feature name (descending) * product_name - Product name * -product_name - Product name (descending) * product_id - Product id * -product_id - Product id (descending)

​
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

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

* 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

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

​
provider_id
integer[]

Filter by provider ID. Can be multiple.

​
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 internal name. Case insensitive. Supports partial matches.

​
reseller_id
integer[]

Filter by reseller ID. Can be multiple.

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"