Developer docs

API quickstart

Start using the CertScore API v2 with curl: create a public website scan, poll status, list public-safe findings, and retrieve latest-domain scan resources.

CertScore outputs are automated public-web observations for review. They are not legal advice, certification, or a compliance determination.

Health

Check the public API surface

curl https://certscore.ai/api/v2/health
curl https://certscore.ai/api/v2/openapi.json

Create

Create or reuse a public scan

curl -X POST https://certscore.ai/api/v2/scans \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $CERTSCORE_API_KEY" \
  -d '{
    "url": "https://example.com",
    "detail": "standard",
    "scanFrom": "eu_ie"
  }'

Scan creation may return a completed scan resource or a queued job resource.

Poll

Poll status when work is pending

curl https://certscore.ai/api/v2/scans/{scanId}/status \
  -H "Authorization: Bearer $CERTSCORE_API_KEY"

Honor Retry-After on pending or throttled responses. Queue time and page runtime can exceed the current HTTP request hold window.

Review

Retrieve findings

curl https://certscore.ai/api/v2/scans/{scanId}/findings \
  -H "Authorization: Bearer $CERTSCORE_API_KEY"

Findings are sourced from already-projected public report artifacts. Evidence examples are compact and capped for public API use.

Latest domain

Find the latest eligible scan

curl https://certscore.ai/api/v2/domains/example.com/latest \
  -H "Authorization: Bearer $CERTSCORE_API_KEY"