---
title: "Registers a device's OPAQUE record."
method: POST
path: "/OPAQUE/Register"
tags: ["OPAQUE"]
---

# Registers a device's OPAQUE record.

`POST /OPAQUE/Register`

## Request

- Base URL: `https://api.pishock.com`
- URL: `https://api.pishock.com/OPAQUE/Register`
- Auth: one of:
  - API key in header `X-PiShock-Token`
  - API key in header `X-PiShock-UserId`
  - API key in header `X-PiShock-Server-Key`
  - API key in header `X-PiShock-Api-Key`

This method requires OPAQUE parameters, alpha and MacAddr

## Request body

- OPAQUERegisterRequest: Request for OPAQUE registration.
  - `Alpha` string: Ristretto-Blinded password.
  - `MacAddr` string: MAC Address of the device.

## Response `200`

Registration started.

## Other responses

- `208`: Device is already registered.
- `400`: Request missing alpha, correct mac, or alpha is too long.
- `503`: OPAQUE Registration failed.

## Changes

- **2026-11-10** `6398a6a65c40`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pishock/apis/pishock-public-api-v1/changes/OPAQUE/Register/post.md)

---

[API](https://skmtc.dev/pishock/apis/pishock-public-api-v1.md) - [All operations](https://skmtc.dev/pishock/apis/pishock-public-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/pishock/apis/pishock-public-api-v1/revisions/6398a6a65c40?raw)