List All Credentials

curl --request POST \
  --url https://api.thehyperstack.com/v1/credentials/all \
  --header 'Content-Type: application/json' \
  --data '
{
  "page": 123,
  "page_size": 123
}
'

import requests

url = "https://api.thehyperstack.com/v1/credentials/all"

payload = {
    "page": 123,
    "page_size": 123
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({page: 123, page_size: 123})
};

fetch('https://api.thehyperstack.com/v1/credentials/all', 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/credentials/all",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'page' => 123,
    'page_size' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.thehyperstack.com/v1/credentials/all"

	payload := strings.NewReader("{\n  \"page\": 123,\n  \"page_size\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.thehyperstack.com/v1/credentials/all")
  .header("Content-Type", "application/json")
  .body("{\n  \"page\": 123,\n  \"page_size\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.thehyperstack.com/v1/credentials/all")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"page\": 123,\n  \"page_size\": 123\n}"

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

{
  "success": true,
  "total": 1,
  "page": 1,
  "page_size": 50,
  "credentials": [
    {
      "document_id": "j4nDvaxF6ehodPXI84p4X1yhQe7lrYgx",
      "document_url": "https://hyperstack.id/credential/j4nDvaxF6ehodPXI84p4X1yhQe7lrYgx",
      "recipient": { "name": "John Doe", "email": "john@example.com" },
      "group": { "title": "Cloud Certification", "key": "GcI6H5b66a3v", "code": "CC-2024" },
      "issued_on": "2024-03-15T10:30:00Z",
      "valid_until": null,
      "metadata": { "custom_location": "Mars" },
      "status": "active",
      "privacy": "public"
    }
  ]
}

{
  "detail": "Invalid token or organization not found"
}

POST

credentials

all

List All Credentials

curl --request POST \
  --url https://api.thehyperstack.com/v1/credentials/all \
  --header 'Content-Type: application/json' \
  --data '
{
  "page": 123,
  "page_size": 123
}
'

import requests

url = "https://api.thehyperstack.com/v1/credentials/all"

payload = {
    "page": 123,
    "page_size": 123
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({page: 123, page_size: 123})
};

fetch('https://api.thehyperstack.com/v1/credentials/all', 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/credentials/all",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'page' => 123,
    'page_size' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.thehyperstack.com/v1/credentials/all"

	payload := strings.NewReader("{\n  \"page\": 123,\n  \"page_size\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.thehyperstack.com/v1/credentials/all")
  .header("Content-Type", "application/json")
  .body("{\n  \"page\": 123,\n  \"page_size\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.thehyperstack.com/v1/credentials/all")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"page\": 123,\n  \"page_size\": 123\n}"

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

{
  "success": true,
  "total": 1,
  "page": 1,
  "page_size": 50,
  "credentials": [
    {
      "document_id": "j4nDvaxF6ehodPXI84p4X1yhQe7lrYgx",
      "document_url": "https://hyperstack.id/credential/j4nDvaxF6ehodPXI84p4X1yhQe7lrYgx",
      "recipient": { "name": "John Doe", "email": "john@example.com" },
      "group": { "title": "Cloud Certification", "key": "GcI6H5b66a3v", "code": "CC-2024" },
      "issued_on": "2024-03-15T10:30:00Z",
      "valid_until": null,
      "metadata": { "custom_location": "Mars" },
      "status": "active",
      "privacy": "public"
    }
  ]
}

{
  "detail": "Invalid token or organization not found"
}

Description

This endpoint allows you to retrieve all credentials issued by your organization, ordered by most recently published, with support for pagination.

Headers

string

required

Bearer YOUR_API_TOKEN — obtainable from Hyperstack Dashboard → Settings → API Access

Body Parameters

number

required

The page number for pagination (default is 1).

number

required

The number of credentials to return per page (default is 50).

Success Response Fields

boolean

Indicates whether the request was successful.

number

Total number of credentials issued by your organization.

array[object]

Array of credential objects. Each object contains:

document_id — unique credential ID
document_url — public URL of the credential
recipient — object with name and email
group — object with title, key, and code
issued_on — ISO 8601 timestamp
valid_until — ISO 8601 expiry timestamp, or null
metadata — custom attribute values
status — "active", "suspended", "expired", "revoked", or "unpublished"
privacy — "public" or "private"

number

Current page number.

number

Number of credentials returned per page.

Responses

{
  "success": true,
  "total": 1,
  "page": 1,
  "page_size": 50,
  "credentials": [
    {
      "document_id": "j4nDvaxF6ehodPXI84p4X1yhQe7lrYgx",
      "document_url": "https://hyperstack.id/credential/j4nDvaxF6ehodPXI84p4X1yhQe7lrYgx",
      "recipient": { "name": "John Doe", "email": "john@example.com" },
      "group": { "title": "Cloud Certification", "key": "GcI6H5b66a3v", "code": "CC-2024" },
      "issued_on": "2024-03-15T10:30:00Z",
      "valid_until": null,
      "metadata": { "custom_location": "Mars" },
      "status": "active",
      "privacy": "public"
    }
  ]
}

{
  "detail": "Invalid token or organization not found"
}

curl -X POST "https://api.thehyperstack.com/v1/credentials/all" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "page": 1,
    "page_size": 50
  }'

Last modified on February 22, 2026

API Guide

Credential Groups

Credentials

Recipients

Webhooks

List All Credentials

Description

Headers

Body Parameters

Success Response Fields

Responses

​Description

​Headers

​Body Parameters

​Success Response Fields

​Responses

Description

Headers

Body Parameters

Success Response Fields

Responses