---
title: "Is this certificate still good? good, revoked (a later measurement failed before expiry), suspended (owner incident), withdrawn (opt-out), expired, never_certified or unknown. Signed (crawlcheck-certificate-status), next_update at most an hour away. POST the certificate JSON instead of the query. Rules: /spec/certificate"
method: GET
path: "/api/v1/certificate/status"
---

# Is this certificate still good? good, revoked (a later measurement failed before expiry), suspended (owner incident), withdrawn (opt-out), expired, never_certified or unknown. Signed (crawlcheck-certificate-status), next_update at most an hour away. POST the certificate JSON instead of the query. Rules: /spec/certificate

`GET /api/v1/certificate/status`

## Request

- Base URL: `https://crawlcheck.io`
- URL: `https://crawlcheck.io/api/v1/certificate/status`
- Auth: none required

## Query parameters

- `domain` string, required
- `record` string, required

## Response `200`

status

- object, nullable
  - `kind` string, nullable
  - `v` number, nullable
  - `domain` string, nullable
  - `record` string, nullable
  - `checked_at` string, nullable
  - `certified_at` string, nullable
  - `expires_at` string, nullable
  - `status` string, nullable
  - `reason` string, nullable
  - `revoked_at` string, nullable
  - `by_record` string, nullable
  - `failed` string[], nullable
  - `next_update` string, nullable
  - `signature` unknown

## Other responses

- `404`: unknown

---

[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)