Skip to content

Link a domain

POST
/v1/issuers/{id}/verify-domain
curl --request POST \
--url https://api.hardstate.net/v1/issuers/example/verify-domain \
--header 'Content-Type: application/json' \
--data '{ "domain": "example" }'

The domain must be the website the issuer’s signed profile declares, and must name the log either at https:///.well-known/hardstate.json ({ issuer, genesis }) or in a TXT record _hardstate.<domain> = “issuer= genesis=”. Otherwise 422, with what to publish: step: "website" (declare it first, with issuer.update) or step: "link" with file: { url, body } and dns: { name, type, value }. Rate-limited per address (429).

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

Example generated

{
"domain": "example"
}

{ verified: domain, via: well-known | dns }

Error

Media typeapplication/json
object
error
string

Example generated

{
"error": "example"
}

Error

Media typeapplication/json
object
error
string

Example generated

{
"error": "example"
}

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