Skip to main content
GET
Has this sandbox been claimed?
Reports whether the sandbox behind the calling key has been claimed yet. An agent that hands its claim_url to a human has no other way to learn what happened. This endpoint closes that loop: poll it with your own key.

Responses

Every response carries a hint in plain language, so an agent can act on the answer without special-casing each shape.
claimed: true is derived from the claim record on the account, not from the account merely being real — otherwise every ordinary account would report as claimed.
The response never includes claim_url. Only the token’s hash is stored, so the URL can’t be reproduced — keep the one from the mint response.

Authorizations

Authorization
string
header
required

Zinc API key (Bearer zn_...)

Headers

authorization
string | null

Response

Successful Response

Whether this sandbox has been claimed yet.

Lets an agent learn the outcome of a claim it can't see — the thing a device-code grant would give it for free (see issue #825).

claimed
boolean
required

True once a human has folded this sandbox into an account — at which point this key is a real account's key and keeps working.

hint
string
required

What to do next given this status.

claimed_by_email
string | null

The claiming account's email, once claimed.