account

Fetch the published challenge, claim the domain, and take the welcome credit

Fetches your published challenge over HTTPS; on a match it claims the domain for your account and, once per account, credits the welcome grant. Verification and the grant are separate outcomes: a verified domain can still earn no credit, and grant_reason says why. No request body. Free and unmetered.

post/v1/account/domain/verify

Request

Base URL: https://api.cogdepot.com
URL: https://api.cogdepot.com/v1/account/domain/verify
Auth: API key in header x-api-key

Response

Success

detailstring required

The same answer in a sentence, always present.

domainstring required

The registrable domain now claimed by this account.

grant_reason'grant_cap_reached'

Why no credit was paid, present only when a grant was due and something refused it. grant_cap_reached means this deployment has issued its maximum grants for the UTC day; your domain is claimed and holds its place, so retry after 00:00 UTC. An account claiming a second domain carries no reason, because nothing went wrong.

grantedboolean required

Whether THIS call credited the welcome grant.

granted_microinteger required

Amount credited in µUSD, zero when granted is false.

verifiedboolean required

Always true in a 200: the proof was fetched and matched.

Example response

{
  "detail": "Domain verified and $10.00 credited to your balance.",
  "domain": "example.invalid",
  "granted": true,
  "granted_micro": 10000000,
  "verified": true
}

Changes

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