List Trials

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

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.gcore.com/billing/org/v1/trials', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gcore.com/billing/org/v1/trials",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gcore.com/billing/org/v1/trials"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.gcore.com/billing/org/v1/trials")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "count": 123,
  "results": [
    {
      "id": 123,
      "client_id": 123,
      "client": {
        "id": 2,
        "company_name": "<string>"
      },
      "product": {
        "id": 123,
        "name": "<string>",
        "internal_name": "<string>"
      },
      "plan": {
        "id": 123,
        "name": "<string>"
      },
      "days_limit": 123,
      "active_ranges": [
        {
          "start": "2023-11-07T05:31:56Z",
          "end": "2023-11-07T05:31:56Z"
        }
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "options": [
        {
          "internal_name": "<string>",
          "name": "<string>",
          "description": "<string>",
          "unit": {
            "id": 2,
            "name": "<string>",
            "internal_name": "<string>"
          },
          "value": 1,
          "used_value": 123,
          "remaining_value": 123,
          "is_limit": true,
          "feature": {
            "id": 123,
            "name": "<string>"
          }
        }
      ],
      "remaining_duration": 123,
      "is_trial_skipped": true
    }
  ],
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100"
}

GET

billing

org

trials

List Trials

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

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.gcore.com/billing/org/v1/trials', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gcore.com/billing/org/v1/trials",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gcore.com/billing/org/v1/trials"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.gcore.com/billing/org/v1/trials")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "count": 123,
  "results": [
    {
      "id": 123,
      "client_id": 123,
      "client": {
        "id": 2,
        "company_name": "<string>"
      },
      "product": {
        "id": 123,
        "name": "<string>",
        "internal_name": "<string>"
      },
      "plan": {
        "id": 123,
        "name": "<string>"
      },
      "days_limit": 123,
      "active_ranges": [
        {
          "start": "2023-11-07T05:31:56Z",
          "end": "2023-11-07T05:31:56Z"
        }
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "options": [
        {
          "internal_name": "<string>",
          "name": "<string>",
          "description": "<string>",
          "unit": {
            "id": 2,
            "name": "<string>",
            "internal_name": "<string>"
          },
          "value": 1,
          "used_value": 123,
          "remaining_value": 123,
          "is_limit": true,
          "feature": {
            "id": 123,
            "name": "<string>"
          }
        }
      ],
      "remaining_duration": 123,
      "is_trial_skipped": true
    }
  ],
  "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

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

client_id

(integer | null)[]

Filter by client ID. Can be multiple.

Required range: -2147483648 <= x <= 2147483647

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>

integer

limit

integer

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

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:

&not_active_at=2025-05-15 12:00:00
&not_active_at=2025-05-15T12:00:00Z

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.

id.asc - Id
id.desc - Id (descending)
created_at.asc - Created at
created_at.desc - Created at (descending)
client_id.asc - Client id
client_id.desc - Client id (descending)
started_at.asc - Started at
started_at.desc - Started at (descending)
ended_at.asc - Ended at
ended_at.desc - Ended at (descending)
plan_name.asc - Plan name
plan_name.desc - Plan name (descending)
plan_id.asc - Plan id
plan_id.desc - Plan id (descending)
product_name.asc - Product name
product_name.desc - Product name (descending)
product_id.asc - Product id
product_id.desc - Product id (descending)

Available options:

client_id.asc,

client_id.desc,

created_at.asc,

created_at.desc,

ended_at.asc,

ended_at.desc,

id.asc,

id.desc,

plan_id.asc,

plan_id.desc,

plan_name.asc,

plan_name.desc,

product_id.asc,

product_id.desc,

product_name.asc,

product_name.desc,

started_at.asc,

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

id - Id
-id - Id (descending)
created_at - Created at
-created_at - Created at (descending)
client_id - Client id
-client_id - Client id (descending)
started_at - Started at
-started_at - Started at (descending)
ended_at - Ended at
-ended_at - Ended at (descending)
plan_name - Plan name
-plan_name - Plan name (descending)
plan_id - Plan id
-plan_id - Plan id (descending)
product_name - Product name
-product_name - Product name (descending)
product_id - Product id
-product_id - Product id (descending)

Available options:

-client_id,

-created_at,

-ended_at,

-id,

-plan_id,

-plan_name,

-product_id,

-product_name,

-started_at,

client_id,

created_at,

ended_at,

id,

plan_id,

plan_name,

product_id,

product_name,

started_at

plan_id

(integer | null)[]

Filter by plan ID. Can be multiple.

plan_name

string

Filter by plan 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.

started_at__isnull

boolean

Filter trials where started_at is null.

Response

Request successful.

count

integer

required

Example:

123

results

object[]

required

Show child attributes

string<uri> | null

Example:

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

string<uri> | null

Example:

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

⌘I

Overview

IAM

CDN

Managed DNS

Cloud

DDoS Protection

FastEdge

WAAP

Streaming

Object Storage

Resellers

List Trials

Authorizations

Query Parameters

Response