Skip to content
Watch by Kiba™Verification registry
Back to the registry
DEVELOPER REFERENCE

Public registry API

Search published website reviews, verify their current status, and display a dated Watch badge.

v1.1.0 Public access · no API key Download OpenAPI JSON

Start here

These endpoints expose published review records only. You don’t need an API key, account or SDK. Requests use HTTPS and return JSON, except for the hosted SVG badge.

Base URL
https://www.kibawatch.com
  1. Find a record. Search for a company, exact domain or badge code.
  2. Retrieve its code. A search result is a directory entry; it is not a live verification.
  3. Read the status. Only active confirms the dated review remains eligible.

A verified dated review is not a certification of legal compliance or security. Findings can remain on Roadmap. Raw evidence, reviewer comments and personal information stay private.

ENDPOINT 1 / 3

Search published reviews

GET/api/watch-registry

Search company names by substring, or match an exact domain or badge code. Search is case-insensitive and whitespace is trimmed. Returns at most 20 records. hasMore indicates that the search should be narrowed; no pagination cursor is available. Directory entries are not a live eligibility check. Private records are omitted.

Parameters

queryquery · required

A company name, exact domain, or badge code. Use 3–120 characters after trimming. Company names match by substring; domains match exactly.

Successful response

Published directory entries. Follow each code to check current status. A successful search with no matches returns records: [].

hasMore: true means you should narrow the search. There is no pagination cursor.

Try this public API
Search cURL request
curl --get 'https://www.kibawatch.com/api/watch-registry' \
  --data-urlencode 'query=example.com' \
  --header 'Accept: application/json'
Example · 200 application/json
{
  "records": [
    {
      "code": "KW-0123456789ABCDEF01234567",
      "companyName": "Example Company",
      "siteUrl": "https://example.com/",
      "domain": "example.com",
      "status": "lookup_required",
      "scanCompletedAt": "2026-10-25T15:00:00Z",
      "reviewCompletedAt": "2026-10-25T16:00:00Z",
      "issuedAt": "2026-10-25T16:10:00Z",
      "revokedAt": null,
      "scope": {
        "baseline": "EU",
        "baselineLabel": "European Union · GDPR",
        "policyComparison": true,
        "checklist": null
      },
      "summary": {
        "checks": 3,
        "passed": 2,
        "notApplicable": 0,
        "warningsAccepted": 1,
        "warningsDisputed": 0,
        "findingsClosed": 0,
        "findingsRoadmapped": 0
      },
      "verificationUrl": "https://www.kibawatch.com/verify/KW-0123456789ABCDEF01234567",
      "notice": "A dated record of a scoped website review and documented human decisions. It is not a legal compliance certification, security guarantee, or regulatory approval. Roadmapped findings may remain open."
    }
  ],
  "hasMore": false
}

Fictional example. This company and badge code are not live records.

ENDPOINT 2 / 3

Verify a review record

GET/api/watch-registry/{code}

Fetch current eligibility for a published dated review. Only status=active is a current verified review. Private and missing records are indistinguishable (404). Public report details appear only when the company has opted to share them. Do not infer current verification from a directory search or from an error.

Parameters

codepath · required

The returned code, beginning KW- and followed by 24 uppercase hexadecimal characters.

Successful response

Public record with current status. HTTP 200 alone does not mean active; inspect status.

Try this public API
Record cURL request
curl 'https://www.kibawatch.com/api/watch-registry/KW-0123456789ABCDEF01234567' \
  --header 'Accept: application/json'
Example · 200 application/json
{
  "code": "KW-0123456789ABCDEF01234567",
  "companyName": "Example Company",
  "siteUrl": "https://example.com/",
  "domain": "example.com",
  "status": "active",
  "scanCompletedAt": "2026-10-25T15:00:00Z",
  "reviewCompletedAt": "2026-10-25T16:00:00Z",
  "issuedAt": "2026-10-25T16:10:00Z",
  "revokedAt": null,
  "scope": {
    "baseline": "EU",
    "baselineLabel": "European Union · GDPR",
    "policyComparison": true,
    "checklist": null
  },
  "summary": {
    "checks": 3,
    "passed": 2,
    "notApplicable": 0,
    "warningsAccepted": 1,
    "warningsDisputed": 0,
    "findingsClosed": 0,
    "findingsRoadmapped": 0
  },
  "verificationUrl": "https://www.kibawatch.com/verify/KW-0123456789ABCDEF01234567",
  "notice": "A dated record of a scoped website review and documented human decisions. It is not a legal compliance certification, security guarantee, or regulatory approval. Roadmapped findings may remain open.",
  "report": {
    "controls": [
      {
        "id": "PRIVACY-001",
        "title": "Privacy notice is discoverable",
        "status": "pass",
        "reviewDisposition": "pass"
      },
      {
        "id": "PRIVACY-003",
        "title": "Retention language is stated",
        "status": "unknown",
        "reviewDisposition": "warning_reviewed"
      },
      {
        "id": "CONSENT-001",
        "title": "Consent choices are available",
        "status": "pass",
        "reviewDisposition": "pass"
      }
    ]
  }
}

Fictional example. This company and badge code are not live records.

ENDPOINT 3 / 3

Get the hosted website badge

GET/api/watch-registry/{code}/badge.svg

Status-aware SVG for a published record. The image reflects current lookup status when fetched. A 200 image can show a revoked, superseded or changed review; use the JSON record for programmatic decisions. Private records return 404. A downloaded image is a static snapshot.

Parameters

codepath · required

The returned code, beginning KW- and followed by 24 uppercase hexadecimal characters.

Successful response

Status-aware SVG image.

A saved SVG cannot update itself. Embed the hosted URL and use the JSON endpoint when an integration needs a status decision.

Try this public API
Badge cURL request
curl 'https://www.kibawatch.com/api/watch-registry/KW-0123456789ABCDEF01234567/badge.svg' \
  --header 'Accept: image/svg+xml' \
  --output watch-badge.svg
HTML website embed
<a href="https://www.kibawatch.com/verify/KW-0123456789ABCDEF01234567">
  <img
    src="https://www.kibawatch.com/api/watch-registry/KW-0123456789ABCDEF01234567/badge.svg"
    alt="Under Kiba™ Watch: dated website review"
    width="520" height="164"
  />
</a>

Response fields

A code lookup returns a ReviewRecord. The search response wraps directory records in records with a hasMore flag; search entries never include report.

ReviewRecord

ReviewRecord response fields
FieldDescription
codestring · requiredKW- followed by 24 uppercase hexadecimal characters. Use the code returned by search.
companyNamestring · requiredCompany name saved when the review badge was issued.
siteUrlstring · requiredThe website URL used for the reviewed scan.
domainstring · requiredNormalized website domain, without a leading www.
scanCompletedAtstring · requiredSaved scan completion time (UTC).
reviewCompletedAtstring · requiredCompletion time of the review represented by this record (UTC).
issuedAtstring · requiredBadge issuance time (UTC).
revokedAtstring | null · requiredRevocation time (UTC), or null.
scopeReviewScope · requiredSee ReviewScope below.
summaryReviewSummary · requiredSee ReviewSummary below.
verificationUrlstring · requiredPublic verification page for this code.
noticestring · requiredExplanation of the dated review and its limits.
statusReviewStatus · requiredSee ReviewStatus below.
reportPublicReport · optionalSee PublicReport below.
ReviewScope
ReviewScope response fields
FieldDescription
baselinestring | null · requiredSelected baseline identifier, or null for a policy-only review.
baselineLabelstring · requiredReadable baseline label.
policyComparisonboolean · requiredWhether comparison against a captured privacy policy was included.
checkliststring | null · requiredCompany checklist label when selected; otherwise null.
ReviewSummary
ReviewSummary response fields
FieldDescription
checksinteger · requiredSelected checks in this review.
passedinteger · requiredCaptured passing checks; reviewed warnings are not converted to passes.
notApplicableinteger · requiredChecks recorded as not applicable.
warningsAcceptedinteger · requiredWarnings accepted with documented explanations.
warningsDisputedinteger · requiredWarnings disputed with documented explanations.
findingsClosedinteger · requiredFindings closed with documented decisions.
findingsRoadmappedinteger · requiredFindings that remain open with documented remediation plans.

When shared, report.controls contains each public-safe check’s id, title, original status and reviewDisposition. Custom checklist wording is replaced with a generic title. Reviewed warnings do not become captured passes.

Statuses & errors

Keep the HTTP result separate from the review’s status. A successful HTTP response can describe a revoked or superseded record.

Review statuses

StatusMeaning
activeCurrent review

The original scoped review is still eligible. This is a dated review record, not a legal or security certification.

revokedRevoked

The company revoked the record. Do not show it as currently verified.

supersededNewer watch exists

A newer completed watch exists for the website. The old record is historical.

evidence_expiredEvidence review due

The source evidence is at least 30 days old; the historical review remains available.

rule_review_dueRule review due

A verified mapped update may affect the reviewed scope and needs reassessment.

review_changedReview changed

The source review changed or no longer meets issuance requirements.

source_unavailableSource unavailable

The source watch cannot be retrieved. Current verification is unconfirmed.

lookup_requiredDirectory entry only

Returned by search. Retrieve the code to check its current status.

HTTP responses

CodeWhat to do
200Request succeeded. For code lookups, inspect status; only active is current. An empty search is also a successful 200.
400The search query is invalid. Supply 3–120 characters.
404The record is missing, private, or the code is invalid. Do not infer verification or whether a private record exists.
405The method is not supported. Use GET; the public API cannot modify records.
429Verification is busy. Back off and respect Retry-After when it is present.
503Verification is temporarily unavailable. Keep current verification unconfirmed and retry later.
Example · 404 application/json
{
  "error": "Verification record not found."
}

Freshness and retries

Verification responses use Cache-Control: no-store. Retrieve current state when making a verification decision. Do not reuse an earlier active result after an error. Limit concurrent requests and use a bounded retry with backoff for 429 or 503. No fixed requests-per-minute allowance is promised.

READ-ONLY EXPLORER

Try a public request

Use a real published company, domain or badge code. example.com is a starting search value; it may return no records.

One public read request. No sign-in, scan or record changes.