GET
/v1/certificate
QuBitLang
Retrieves a provenance certificate for a previous request. Certificates contain the full chain of custody: QuBitLang circuit, quantum backend, NIST verification, and cryptographic hashes proving the entropy's quantum origin.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Certificate ID (returned in response metadata) |
| format | string | No | Response format: json (default) or pdf |
Code Examples
certificate.py
from trueentropy import TrueEntropy
client = TrueEntropy(api_key="te_live_YOUR_KEY")
# Get integers and retrieve the certificate
result = client.integers(count=5)
cert_id = result.metadata.certificate_id
cert = client.certificate(id=cert_id)
print(cert.provenance.qubitlang_circuit)
# "qrng_hadamard_v2.3"
print(cert.verification.nist_sp800_22)
# "7/7 passed"
certificate.js
import { TrueEntropy } from '@trueentropy/sdk';
const client = new TrueEntropy('te_live_YOUR_KEY');
const cert = await client.certificate({
id: 'cert_a7f2b9c4d8e1'
});
console.log(cert.certificate.provenance);
console.log(cert.certificate.verify_url);
certificate.php
use TrueEntropy\Client;
$client = new Client('te_live_YOUR_KEY');
$cert = $client->certificate([
'id' => 'cert_a7f2b9c4d8e1',
]);
echo $cert->provenance->qubitlang_circuit;
echo $cert->verify_url;
Terminal
curl https://api.trueentropy.net/v1/certificate \
-H "Authorization: Bearer te_live_YOUR_KEY" \
-G -d "id=cert_a7f2b9c4d8e1"
Response
200 OKJSON
{
"certificate": {
"id": "cert_a7f2b9c4d8e1",
"status": "valid",
"issued_at": "2026-03-09T15:42:17Z",
"request_id": "req_a1b2c3d4e5f6",
"provenance": {
"qubitlang_circuit": "qrng_hadamard_v2.3",
"qubitlang_version": "1.4.0",
"quantum_backend": "ibm_fez",
"qubits_used": 8,
"circuit_depth": 1
},
"verification": {
"nist_sp800_22": "7/7 passed",
"dieharder": "not yet implemented",
"min_entropy_per_bit": 0.9998
},
"hashes": {
"raw_output": "sha256:a7f2b9c4d8e1f3a5b7c9...",
"processed": "sha256:c3d5e7f9a1b3c5d7e9f1...",
"delivered": "sha256:b0c2d4e6f8a0b2c4d6e8..."
},
"verify_url": "https://trueentropy.net/verify/?id=cert_a7f2b9c4d8e1"
}
}
Response Headers
X-QuBitLang-Circuit: qrng_hadamard_v2.3
X-QuBitLang-Version: 1.4.0
Content-Type: application/json // or application/pdf if format=pdf
Errors
| Status | Code | Description |
|---|---|---|
| 400 | invalid_id | Certificate ID format is invalid |
| 401 | auth_missing | No API key provided |
| 401 | auth_invalid | API key is invalid or revoked |
| 404 | cert_not_found | Certificate ID does not exist |
| 429 | rate_limited | Rate limit exceeded |
Public Verification
Any certificate can be independently verified via the public verification page at
trueentropy.net/verify/.
This allows auditors, regulators, and end-users to confirm the quantum provenance of any entropy generated through TrueEntropy.