Get list of existing accounts

GET

accounts

curl --request GET \
  --url https://api-network.joinmassive.com/resellers/accounts \
  --header 'x-api-key: <api-key>'

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

fetch('https://api-network.joinmassive.com/resellers/accounts', 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-network.joinmassive.com/resellers/accounts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <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-network.joinmassive.com/resellers/accounts"

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

	req.Header.Add("x-api-key", "<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-network.joinmassive.com/resellers/accounts")

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

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

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

[
  {
    "id": "57ed834f-f6f6-47d4-ab23-5674d7866b32",
    "username": "johndoe@reseller.com",
    "password": "secret",
    "status": "enabled",
    "limit_reached": false,
    "started_at": 1708526022,
    "updated_at": 1708528022,
    "limit": 1000000,
    "used_bytes": 524288000,
    "domains_blocklist": [
      "example.com",
      "test.org"
    ],
    "sync_with_parent": false,
    "proxy_access": true
  }
]

{
  "error": "Unauthorized"
}

{
  "error": "Internal server error"
}

Authorizations

x-api-key

string

header

required

Response

List of users

string

The account ID (uuid).

Example:

"57ed834f-f6f6-47d4-ab23-5674d7866b32"

username

string

The account username.

Example:

"johndoe@reseller.com"

password

string

The account password.

Example:

"secret"

status

string

The account status (credentials enabled/disabled).

Example:

"enabled"

limit_reached

boolean

The account limit reached status.

Example:

false

started_at

integer

The time in unix seconds at which the account was started.

Example:

1708526022

updated_at

integer

The time in unix seconds at which the account was updated.

Example:

1708528022

limit

integer

The allocated traffic in bytes.

Example:

1000000

used_bytes

integer

Cumulative (lifetime) traffic used by the account, in bytes. This is the figure the account allowance is enforced against, so compare it directly with limit (see also limit_reached). Updated periodically from aggregated usage data, so it is near-real-time rather than instantaneous.

Because this field is returned for every subaccount by GET /accounts, a single call to that endpoint gives you usage for all of your subaccounts at once. Prefer it over calling GET /accounts/{id}/usage once per subaccount.

Example:

524288000

domains_blocklist

string[]

List of domains blocked for this account.

Example:

["example.com", "test.org"]

sync_with_parent

boolean

If true, synchronize the new account's domains blocklist with the parent account. The sub-account can still have its own blocklist entries, which are merged with the parent's.

Example:

false

proxy_access

boolean

Whether the account currently has proxy access. Reflects the actual proxy status from the network layer, which may differ from account status if access was not revoked by user (e.g. usage limit reached).

Example:

true

Get list of existing accounts

curl --request GET \
  --url https://api-network.joinmassive.com/resellers/accounts \
  --header 'x-api-key: <api-key>'

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

fetch('https://api-network.joinmassive.com/resellers/accounts', 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-network.joinmassive.com/resellers/accounts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <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-network.joinmassive.com/resellers/accounts"

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

	req.Header.Add("x-api-key", "<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-network.joinmassive.com/resellers/accounts")

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

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

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

[
  {
    "id": "57ed834f-f6f6-47d4-ab23-5674d7866b32",
    "username": "johndoe@reseller.com",
    "password": "secret",
    "status": "enabled",
    "limit_reached": false,
    "started_at": 1708526022,
    "updated_at": 1708528022,
    "limit": 1000000,
    "used_bytes": 524288000,
    "domains_blocklist": [
      "example.com",
      "test.org"
    ],
    "sync_with_parent": false,
    "proxy_access": true
  }
]

{
  "error": "Unauthorized"
}

{
  "error": "Internal server error"
}

Get Started

Proxy Configuration

Sample Integrations

Reporting API

Reseller API

Others

Get list of existing accounts

Authorizations

Response