GET
/
billing
/
v3
/
trials
Get trials
curl --request GET \
  --url https://api.gcore.com/billing/v3/trials \
  --header 'Authorization: <api-key>'
{
  "count": 123,
  "next": "https://api.gcore.com/billing/v3/trials?offset=20&limit=10",
  "previous": "https://api.gcore.com/billing/v3/trials?offset=10&limit=10",
  "result": [
    {
      "id": 123,
      "client_id": 123,
      "client_company": "Client Company",
      "product_id": 123,
      "product_internal_name": "CDN",
      "product_name_en": "CDN",
      "plan_id": 123,
      "plan_name_en": "Plan name",
      "days_limit": 123,
      "started_at": "2023-11-07T05:31:56Z",
      "ended_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "options": [
        {
          "id": 123,
          "trial_id": 123,
          "feature_id": 123,
          "name_en": "Trial traffic volume",
          "description_en": "Traffic volume given to a client during the trial.",
          "internal_name": "CDN_TRIAL_TRAFFIC_LIMIT",
          "unit_id": 123,
          "value": 300,
          "is_limit": true,
          "used_value": "124,00000000",
          "feature_name_en": "CDN-HTTP/HTTPS Delivery (GB)",
          "unit_name_en": "GB",
          "updated_at": "2023-11-07T05:31:56Z"
        }
      ]
    }
  ]
}

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

limit
integer
required

The maximum number of items. (max value = 100)

offset
integer

Offset relative to the beginning of list.

ordering
string

The parameter using for sorting data. 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.

  • id sort by trial's ID.
  • client_id sort by client's ID.
  • started_at sort by start date.
  • ended_at sort by end date.
Example:

"client_id,-started_at"

id
integer

Filter by trial ID.

client_id
integer

Filter by client ID.

product_id
integer

Specify product ID. Possible values:

IDNameInternal Name
1CDNCDN
2Object StorageSTORAGE
3Web SecurityDDOS
4StreamingSTREAMING
5CloudCLOUD
6Colocation ServicesCONNECT
9DDoS ProtectionINFRASTRUCTURE_PROTECTION
10Managed DNSDNS
11Other ServicesOTHER_SERVICES
12Premium SupportPREMIUM_SUPPORT
13ConnectivityCONNECTIVITY
14Hosting (G-Hosting)GHOST
15Managed ServicesMANAGED_SERVICES
16RentRENT
17Software developmentSOFTWARE_DEVELOPMENT
18VM WareVMWARE
19LaaSLAAS
20AWS CloudAWS_CLOUD
21Fast EdgeFAST_EDGE
22Technical SupportTECHNICAL_SUPPORT
started_at__from
string<date-time>

Filter all trials that started after this date.

started_at__to
string<date-time>

Filter all trials that started before this date.

ended_at__from
string<date-time>

Filter all trials that ended after this date.

ended_at__to
string<date-time>

Filter all trials that ended before this date.

started_at
string<date-time>

Filter all trials that started in this date. null - to get trials without a start date.

ended_at
string<date-time>

Filter all trials that ended in this date. null - to get trials without an end date.

Response

200
application/json

OK.

The response is of type object.