---
title: "Whether proven control of a domain still holds: the claim's state (proven, proof_missing, lapsed, suspended_transfer, suspended_expired, zone_not_rechecked, unproven), when the proof was last found, the next check, the grace end when the proof is missing, the registration record at claim time against now, and the lifecycle events. Proofs are re-checked every 30 days; a lapsed or suspended claim grants owner access to nobody until control is proven again. Signed (crawlcheck-domain-control)."
method: GET
path: "/api/v1/domain/control"
---

# Whether proven control of a domain still holds: the claim's state (proven, proof_missing, lapsed, suspended_transfer, suspended_expired, zone_not_rechecked, unproven), when the proof was last found, the next check, the grace end when the proof is missing, the registration record at claim time against now, and the lifecycle events. Proofs are re-checked every 30 days; a lapsed or suspended claim grants owner access to nobody until control is proven again. Signed (crawlcheck-domain-control).

`GET /api/v1/domain/control`

## Request

- Base URL: `https://crawlcheck.io`
- URL: `https://crawlcheck.io/api/v1/domain/control`
- Auth: none required

## Query parameters

- `domain` string, required

## Response `200`

signed state

- object, nullable
  - `kind` string, nullable
  - `v` number, nullable
  - `domain` string, nullable
  - `state` string, nullable
  - `means` string, nullable
  - `method` string, nullable
  - `claimed_at` string, nullable
  - `last_verified_at` string, nullable
  - `last_check_at` string, nullable
  - `next_check_at` string, nullable
  - `grace_ends_at` unknown
  - `registry_at_claim` object, nullable
    - `created` string, nullable
    - `expires` string, nullable
    - `registrar` string, nullable
  - `events` unknown[], nullable
    - unknown

## Other responses

- `400`: bad domain
- `503`: claim store unreadable

---

[API](https://skmtc.dev/crawlcheck/apis/crawlcheck-api.md) · [All operations](https://skmtc.dev/crawlcheck/apis/crawlcheck-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlcheck/apis/crawlcheck-api/revisions/57acbd6d4489?raw)