---
title: "Developer entropy endpoint (API key)"
method: GET
path: "/v1/random/bytes"
tags: ["developer"]
---

# Developer entropy endpoint (API key)

`GET /v1/random/bytes`

## Request

- Base URL: `https://api.qeaas.eu`
- URL: `https://api.qeaas.eu/v1/random/bytes`
- Auth: API key in header `X-API-Key`

AC-4: canonical dev endpoint. Per-key rate limit + daily quota, then usage log.

## Query parameters

- `size` integer, required
- `format` 'hex' | 'base64'

## Response `200`

Successful Response

- V1RandomBytesResponse
  - `request_id` string, required
  - `format` 'hex' | 'base64', required
  - `data` string, required
  - `entropy_epoch` integer, required
  - `timestamp` string, date-time, required
  - `receipt` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/qeaas/apis/quantum-entropy-as-a-service.md) · [All operations](https://skmtc.dev/qeaas/apis/quantum-entropy-as-a-service/llms.txt) · [OpenAPI document](https://skmtc.dev/qeaas/apis/quantum-entropy-as-a-service/revisions/f0670c8db625?raw)