Claiming an entry

Start a claim

Starts proving that you run the person or organisation an entry is about. It answers a token: publish it on a page the entry lists (url), in a DNS TXT record of its website’s domain (dns); or, for email, no token is needed: your account’s verified email must be an address the entry lists, or admin@, administrator@, webmaster@, hostmaster@ or postmaster@ at a domain it lists. The site then checks it for itself. An entry closed to claims is refused. An entry someone else holds can be claimed too: its proof asks an administrator for a transfer.

post/api/entity/{vhid}/claims

Request

  • Base URL: https://verifiedhandles.org
  • URL: https://verifiedhandles.org/api/entity/{vhid}/claims
  • Auth: HTTP bearer

Path parameters

vhidstring required

The entry’s VHID (11 digits).

Request body

method'url' | 'dns' | 'email' required
targetstring

For url, the page; for dns, the domain. Not used for email.

Response

The claim, with its token.

oktrue required
claimIdstring required

The claim’s id, to check it with.

tokenstring required

The token to publish where the method says.

expires_atstring date-time required

When the token stops working: a week from now.

method'url' | 'dns' | 'email' required
instructionsstring required

Where to put the token, in words.

Changes

No recorded changes to this operation across all 1 revision of this API.