API Reference
Complete reference for all TrueEntropy REST API endpoints. Every response includes
QuBitLang provenance metadata. Base URL: https://api.trueentropy.net/v1
Endpoints
GET
/v1/integers
Random integers within any range
GET
/v1/bytes
Raw random bytes (hex or base64)
GET
/v1/floats
IEEE 754 random floats between 0 and 1
GET
/v1/uuid
Quantum-seeded v4 UUIDs
GET
/v1/bitstring
Raw quantum random bitstrings
GET
/v1/shuffle
Fisher-Yates shuffle with quantum entropy
POST
/v1/batch
Bulk request up to 100,000 values
GET
/v1/certificate
Provenance certificate retrieval
GET
/v1/health
API and system health status
GET
/v1/usage
Account usage statistics
Authentication
All requests require an API key via the Authorization header:
Authorization: Bearer te_live_a7f2b9c4d8e1f3a5...
Response Format
All responses are application/json and include QuBitLang metadata:
{
"data": { ... },
"metadata": {
"request_id": "req_...",
"timestamp": "2026-03-09T15:42:17Z",
"qubitlang_circuit": "qrng_hadamard_v2.3",
"qubitlang_version": "1.4.0",
"quantum_backend": "ibm_fez",
"nist_verified": true,
"powered_by": "QuBitLang"
}
}
Custom Response Headers
| Header | Example | Description |
|---|---|---|
| X-QuBitLang-Circuit | qrng_hadamard_v2.3 | QuBitLang circuit used |
| X-QuBitLang-Version | 1.4.0 | QuBitLang compiler version |
| X-Quantum-Backend | ibm_fez | IBM quantum processor |
| X-NIST-Verified | true | NIST SP800-22 verification status |
| X-RateLimit-Remaining | 47 | Requests remaining this minute |
| X-RateLimit-Reset | 1741536180 | Unix timestamp of rate limit reset |
Rate Limiting
| Tier | Requests/Min | Requests/Month | Burst (150%) |
|---|---|---|---|
| Free | 10 | 1,000 | 15 |
| Developer | 100 | 50,000 | 150 |
| Pro | 500 | 500,000 | 750 |
| Business | 2,000 | 5,000,000 | 3,000 |
| Enterprise | Custom | Unlimited | Custom |