account

Subscribe to Certified Live: charge one 30-day period ($9.00, 18,000 credits) and turn renewal on

Subscribes to Certified Live: charges one 30-day period of $9.00 (18,000 credits) and turns renewal on. API key only. Needs a verified domain for your deal route (409 certification_domain_unverified), an account funded with real money at least once (409 certification_unfunded) and a passing free test on your current route within 24 hours (409 certification_test_required). The fee, the paid period and its certification_fee journal entry are written in one transaction; a balance that does not cover the fee is 402 insufficient_funds_self and writes nothing. A period that is paid and renewing is 409 certification_already_active. An inactive account (its key disabled) is 403 api_key_disabled. A canceled period that is still paid is resumed free. A replay with the same Idempotency-Key returns the original result and never charges twice. Nothing is refunded: the fee buys the checks, not the badge.

post/v1/account/certification

Request

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

Headers

Idempotency-Keystring uuid required

REQUIRED. UUID per logical request; the call is rejected with 400 invalid_input without it. Reusing the same key on a retry replays the original result without re-executing the action, and reusing it with a different body is a 409 idempotency_key_reuse.

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.