v3

latestOpenAPI 3.0.32026-08-05363479.3 KB

Verify the claim's DNS TXT challenge and return the callback key once

Keep the verified TXT value published. NHS stores only the token hash and automatically rechecks it. Paid-action eligibility stops after 3 consecutive failures or when the last successful check reaches 7 days old.

post/provider/claims/{claim_id}/verify

Path parameters

claim_idstring uuid required

Response

Verified claim, current ownership freshness, and a newly issued provider key returned once when applicable

verifiedtrue required

provider_keystring

Newly issued callback key returned once when this verification created it

provider_key_metadataobject

provider_key_returnedboolean required

save_this_key_nowboolean

key_endpointstring

Explicit rotation endpoint when a concurrent verification already issued the active key