Skip to content

The refused writes that claimed one of the issuer's keys, signed by someone of the institution

POST
/v1/issuers/{id}/rejections/read
curl --request POST \
--url https://api.hardstate.net/v1/issuers/example/rejections/read \
--header 'Content-Type: application/json' \
--data '{ "request": { "op": "billing.checkout", "issuer": "example", "key": "example", "ts": "2026-04-15T12:00:00Z", "nonce": "example", "params": {} }, "sig": { "kind": "passkey", "authenticatorData": "example", "clientDataJSON": "example", "signature": "example" } }'

op: "rejections.read", signed by a person of the institution or a session they opened; params may carry key and limit (≤ 500). A rejected event proves nothing about who sent it, so key is only the signer it claimed; claims by unknown keys are only counted. Codes: stale_head, bad_signature, revoked_key, expired, out_of_scope, not_allowed, malformed, doc_mismatch, invalid.

id
required
string
/^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$/
Media typeapplication/json

Not a log event: an admin’s instruction to the operator. The signed hash is sha256(“hardstate/operator/v1” ‖ JCS(request)); accepted within 5 minutes of ts, once per nonce, from a live admin key of the issuer.

object
request
required
object
op
required
Allowed values: billing.checkout billing.invoice billing.portal anchor.express
issuer
required
string
key
required

The signing admin key id

string
ts
required
string format: date-time
nonce
required

16 random bytes

string
params
object
sig
required
One of:
object
kind
required
Allowed value: passkey
authenticatorData
required
string
clientDataJSON
required
string
signature
required
string

{ issuer, rejections: [{ at, key, type, code, message }], last7d: { : { total, byCode } }, unknownKeys7d, refused7d }

Error

Media typeapplication/json
object
error
string

Example generated

{
"error": "example"
}

HardState is a Zevlat Intelligence venture. © 2026 Zevlat Intelligence.