List Bonuses

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

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

fetch('https://api.gcore.com/billing/org/v1/bonuses', 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/bonuses",
  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/bonuses"

	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/bonuses")

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,
      "created_at": "2023-11-07T05:31:56Z",
      "active_from": "2023-11-07T05:31:56Z",
      "active_to": "2023-11-07T05:31:56Z",
      "client_id": -1,
      "amount": "<string>",
      "client_company": "<string>",
      "currency_char_code": "<string>",
      "description": "<string>",
      "product_category_ids": [
        123
      ]
    }
  ],
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100"
}

GET

billing

org

bonuses

List Bonuses

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

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

fetch('https://api.gcore.com/billing/org/v1/bonuses', 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/bonuses",
  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/bonuses"

	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/bonuses")

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,
      "created_at": "2023-11-07T05:31:56Z",
      "active_from": "2023-11-07T05:31:56Z",
      "active_to": "2023-11-07T05:31:56Z",
      "client_id": -1,
      "amount": "<string>",
      "client_company": "<string>",
      "currency_char_code": "<string>",
      "description": "<string>",
      "product_category_ids": [
        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

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_from

string<date-time>

active_from__from

string<date-time>

active_from__to

string<date-time>

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

active_to

string<date-time>

active_to__from

string<date-time>

active_to__to

string<date-time>

client_id

integer

ID of client in API service

Required range: -2147483648 <= x <= 2147483647

created_at

string<date-time>

created_at__from

string<date-time>

created_at__to

string<date-time>

currency_char_code

string

description

string

Filter by description. Case insensitive, partial match.

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)
active_from.asc - Active from
active_from.desc - Active from (descending)
active_to.asc - Active to
active_to.desc - Active to (descending)
client_id.asc - Client id
client_id.desc - Client id (descending)
amount.asc - Amount
amount.desc - Amount (descending)
client_company.asc - Client company
client_company.desc - Client company (descending)

Available options:

active_from.asc,

active_from.desc,

active_to.asc,

active_to.desc,

amount.asc,

amount.desc,

client_company.asc,

client_company.desc,

client_id.asc,

client_id.desc,

created_at.asc,

created_at.desc,

id.asc,

id.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)
active_from - Active from
-active_from - Active from (descending)
active_to - Active to
-active_to - Active to (descending)
client_id - Client id
-client_id - Client id (descending)
amount - Amount
-amount - Amount (descending)
client_company - Client company
-client_company - Client company (descending)

Available options:

-active_from,

-active_to,

-amount,

-client_company,

-client_id,

-created_at,

-id,

active_from,

active_to,

amount,

client_company,

client_id,

created_at,

id

product_category_external_id

string

Filter by product category external ID. 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.

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 Bonuses

Authorizations

Query Parameters

Response