---
title: "QRNG-seeded ML-KEM encapsulation"
method: POST
path: "/v1/kem/encapsulate"
tags: ["kem"]
---

# QRNG-seeded ML-KEM encapsulation

`POST /v1/kem/encapsulate`

## Request

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

AC-4/7: QRNG-seeded encapsulation against a supplied `ek`.

## Request body

- KemEncapsulateRequest
  - `public_key` string, required
  - `include_shared_secret` boolean

## Response `200`

Successful Response

- KemEncapsulateResponse
  - `request_id` string, required
  - `algorithm` 'ML-KEM-768', required
  - `format` 'base64', required
  - `ciphertext` string, required
  - `shared_secret` string, nullable
  - `demo_key` string, nullable
  - `entropy_epoch` integer, required
  - `timestamp` string, date-time, required
  - `receipt` string, nullable
  - `note` 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)