account

Stop Certified Live renewal; the paid period runs to its end

Stops Certified Live renewal and returns the same status body as GET /v1/account/certification. Retry-safe without an Idempotency-Key, and the header is not read: cancelling is naturally idempotent, so a repeat returns the same state. Nothing is refunded and the paid period is not cut short.

post/v1/account/certification/cancel

Request

  • Base URL: https://api.cogdepot.com
  • URL: https://api.cogdepot.com/v1/account/certification/cancel
  • Auth: API key in header x-api-key

Response

Success

auto_renewboolean required

Whether the next period is charged automatically when this one ends. Cancel turns it off and changes nothing else.

domain_verifiedboolean required

Whether this account has a verified domain, which is a precondition of passing. Prove one at POST /v1/account/domain/verify.

fee_creditsinteger required

The price of one period, in credits.

fee_microinteger required

The price of one period, in µUSD.

next_probe_atstring date-time nullable required

When the next scheduled probe is due (RFC 3339), null when none is scheduled.

paid_throughstring date-time nullable required

End of the period already paid for (RFC 3339), null when nothing has been paid. Cover does not stop at cancel: it runs to this instant either way.

passing_nowboolean required

Paid, on a verified domain, at least the minimum samples, the pass ratio met, and the newest scheduled probe passed within the last 12 hours.

period_daysinteger required

The length of one paid period, in days.

public_as_ofstring

UTC date of the daily snapshot public_certified starts from.

public_certifiedboolean required

The value public surfaces show now.

routestring required

Your current deal route.

status'none' | 'active' | 'canceled' | 'lapsed' required

none, active, canceled or lapsed. An account that never subscribed reads none here rather than a 404, so this call is safe to make before deciding.

window_routestring required

The deal route the window and recent results were collected against. Differs from route after a route change, until the next scheduled probe starts a new window.

Example response

{
  "auto_renew": true,
  "domain_verified": true,
  "fee_credits": 18000,
  "fee_micro": 9000000,
  "last_test": {
    "at": "2026-08-06T19:51:01Z",
    "passed": true,
    "route": "https://route.example.invalid/d/"
  },
  "next_probe_at": "2026-08-07T01:51:01Z",
  "paid_through": "2026-09-05T19:51:01Z",
  "passing_now": true,
  "period_days": 30,
  "public_as_of": "2026-08-06",
  "public_certified": true,
  "recent": [
    {
      "at": "2026-08-06T20:02:14Z",
      "passed": true
    },
    {
      "at": "2026-08-06T19:51:01Z",
      "passed": true
    }
  ],
  "route": "https://route.example.invalid/d/",
  "status": "active",
  "window": {
    "passes": 12,
    "required_pass_percent": 90,
    "required_samples": 4,
    "samples": 12,
    "window_samples": 28
  },
  "window_route": "https://route.example.invalid/d/"
}

Changes

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