---
title: "Roll dice with quantum-seeded randomness"
method: POST
path: "/dice"
tags: ["public"]
---

# Roll dice with quantum-seeded randomness

`POST /dice`

## Request

- Base URL: `https://api.qeaas.eu`
- URL: `https://api.qeaas.eu/dice`
- Auth: none declared

AC-3: rejection-sampled dice rolls, ungated. AC-1: per-IP rate limit.

EPIC 5 Q2: echoes every DRBG byte drawn for the roll (accepted + rejected)
so the web dice player's "bytes behind this roll" toggle is literal.

## Request body

- DiceRequest
  - `sides` integer
  - `count` integer

## Response `200`

Successful Response

- DiceResponse
  - `sides` integer, required
  - `count` integer, required
  - `rolls` integer[], required
  - `format` 'base64', required
  - `bytes_used` string, required
  - `bytes_count` integer, required

## 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)