GET
/v1/uuid
QuBitLang
Generates RFC 4122 v4 UUIDs seeded with quantum entropy. Unlike standard v4 UUIDs which rely on PRNGs, these are backed by true quantum randomness from IBM quantum hardware.
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| count | integer | No | 1 | Number of UUIDs to generate (1–1,000) |
Code Examples
uuid.py
from trueentropy import TrueEntropy
client = TrueEntropy(api_key="te_live_YOUR_KEY")
result = client.uuid(count=3)
for uid in result.uuids:
print(uid)
# a7f2b9c4-d8e1-4f3a-b5c7-d9e2f4a6b8c0
# c3d5e7f9-a1b3-4c5d-97e9-f1a3b5c7d9e1
# e5f7a9b1-c3d5-4e7f-89a1-b3c5d7e9f1a3
uuid.js
import { TrueEntropy } from '@trueentropy/sdk';
const client = new TrueEntropy('te_live_YOUR_KEY');
const result = await client.uuid({ count: 3 });
console.log(result.data.uuids);
// ["a7f2b9c4-d8e1-4f3a-b5c7-d9e2f4a6b8c0", ...]
uuid.php
use TrueEntropy\Client;
$client = new Client('te_live_YOUR_KEY');
$result = $client->uuid(['count' => 3]);
foreach ($result->uuids as $uid) {
echo $uid . "\n";
}
Terminal
curl https://api.trueentropy.net/v1/uuid \
-H "Authorization: Bearer te_live_YOUR_KEY" \
-G -d "count=3"
Response
200 OKJSON
{
"data": {
"uuids": [
"a7f2b9c4-d8e1-4f3a-b5c7-d9e2f4a6b8c0",
"c3d5e7f9-a1b3-4c5d-97e9-f1a3b5c7d9e1",
"e5f7a9b1-c3d5-4e7f-89a1-b3c5d7e9f1a3"
],
"count": 3,
"version": 4
},
"metadata": {
"request_id": "req_d4e5f6a7b8c9",
"timestamp": "2026-03-09T15:42:17Z",
"qubitlang_circuit": "qrng_hadamard_v2.3",
"qubitlang_version": "1.4.0",
"quantum_backend": "ibm_fez",
"nist_verified": true,
"certificate_id": "cert_d4e5f6a7b8c9",
"powered_by": "QuBitLang"
}
}
Response Headers
X-QuBitLang-Circuit: qrng_hadamard_v2.3
X-QuBitLang-Version: 1.4.0
X-Quantum-Backend: ibm_fez
X-NIST-Verified: true
X-RateLimit-Remaining: 47
X-RateLimit-Reset: 1741536180
Errors
| Status | Code | Description |
|---|---|---|
| 400 | invalid_count | count must be between 1 and 1,000 |
| 401 | auth_missing | No API key provided |
| 401 | auth_invalid | API key is invalid or revoked |
| 429 | rate_limited | Rate limit exceeded |