View Credential Group
curl --request GET \
--url https://api.thehyperstack.com/v1/group/view/{group_key} \
--header 'Authorization: <authorization>'import requests
url = "https://api.thehyperstack.com/v1/group/view/{group_key}"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.thehyperstack.com/v1/group/view/{group_key}', 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.thehyperstack.com/v1/group/view/{group_key}",
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: <authorization>"
],
]);
$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.thehyperstack.com/v1/group/view/{group_key}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.thehyperstack.com/v1/group/view/{group_key}")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.thehyperstack.com/v1/group/view/{group_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"success": true,
"title": "Cloud Security Fundamentals",
"description": "Awarded for completing the Cloud Security Fundamentals course.",
"tags": "security,cloud",
"group_code": "CSF-2026",
"url": "https://acme.example.com/courses/cloud-security",
"does_expire": true,
"validity": 2
}
{
"success": false,
"error": "Group Not Found",
"error_code": "not_found"
}
{
"detail": "Invalid token or organization not found"
}
Credential Groups
View Credential Group
GET
/
v1
/
group
/
view
/
{group_key}
View Credential Group
curl --request GET \
--url https://api.thehyperstack.com/v1/group/view/{group_key} \
--header 'Authorization: <authorization>'import requests
url = "https://api.thehyperstack.com/v1/group/view/{group_key}"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.thehyperstack.com/v1/group/view/{group_key}', 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.thehyperstack.com/v1/group/view/{group_key}",
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: <authorization>"
],
]);
$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.thehyperstack.com/v1/group/view/{group_key}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.thehyperstack.com/v1/group/view/{group_key}")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.thehyperstack.com/v1/group/view/{group_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"success": true,
"title": "Cloud Security Fundamentals",
"description": "Awarded for completing the Cloud Security Fundamentals course.",
"tags": "security,cloud",
"group_code": "CSF-2026",
"url": "https://acme.example.com/courses/cloud-security",
"does_expire": true,
"validity": 2
}
{
"success": false,
"error": "Group Not Found",
"error_code": "not_found"
}
{
"detail": "Invalid token or organization not found"
}
Description
Returns the details of one credential group.POST works too.
Headers
string
required
Your API key:
Bearer YOUR_API_KEY. Create a key in the Studio under Settings → Developers.Path Parameters
string
required
Key of the group.
Success Response Fields
boolean
true when the group was found.string
Title of the group.
string
Description of the group.
string
The group’s tags in one string, separated by commas, such as
"security,cloud".string
Short code of the group.
string
Web page of the group. Empty string when not set.
boolean
true when credentials in this group expire.number
How many years a credential is valid after it is published. Only in the response when
does_expire is true.Responses
{
"success": true,
"title": "Cloud Security Fundamentals",
"description": "Awarded for completing the Cloud Security Fundamentals course.",
"tags": "security,cloud",
"group_code": "CSF-2026",
"url": "https://acme.example.com/courses/cloud-security",
"does_expire": true,
"validity": 2
}
{
"success": false,
"error": "Group Not Found",
"error_code": "not_found"
}
{
"detail": "Invalid token or organization not found"
}
curl "https://api.thehyperstack.com/v1/group/view/Kq7Zp2LmX9aB" \
-H "Authorization: Bearer YOUR_API_KEY"
Last modified on October 20, 2026
Was this page helpful?

