Public registry API
Search published website reviews, verify their current status, and display a dated Watch badge.
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.
https://www.kibawatch.com- Find a record. Search for a company, exact domain or badge code.
- Retrieve its code. A search result is a directory entry; it is not a live verification.
- Read the status. Only
activeconfirms 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.
Search published reviews
/api/watch-registrySearch 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 · requiredA 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.
curl --get 'https://www.kibawatch.com/api/watch-registry' \
--data-urlencode 'query=example.com' \
--header 'Accept: 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.
Verify a review record
/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 · requiredThe 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 APIcurl 'https://www.kibawatch.com/api/watch-registry/KW-0123456789ABCDEF01234567' \
--header 'Accept: 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.
Get the hosted website badge
/api/watch-registry/{code}/badge.svgStatus-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 · requiredThe 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 APIcurl 'https://www.kibawatch.com/api/watch-registry/KW-0123456789ABCDEF01234567/badge.svg' \
--header 'Accept: image/svg+xml' \
--output watch-badge.svg<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
| Field | Description |
|---|---|
codestring · required | KW- followed by 24 uppercase hexadecimal characters. Use the code returned by search. |
companyNamestring · required | Company name saved when the review badge was issued. |
siteUrlstring · required | The website URL used for the reviewed scan. |
domainstring · required | Normalized website domain, without a leading www. |
scanCompletedAtstring · required | Saved scan completion time (UTC). |
reviewCompletedAtstring · required | Completion time of the review represented by this record (UTC). |
issuedAtstring · required | Badge issuance time (UTC). |
revokedAtstring | null · required | Revocation time (UTC), or null. |
scopeReviewScope · required | See ReviewScope below. |
summaryReviewSummary · required | See ReviewSummary below. |
verificationUrlstring · required | Public verification page for this code. |
noticestring · required | Explanation of the dated review and its limits. |
statusReviewStatus · required | See ReviewStatus below. |
reportPublicReport · optional | See PublicReport below. |
ReviewScope
| Field | Description |
|---|---|
baselinestring | null · required | Selected baseline identifier, or null for a policy-only review. |
baselineLabelstring · required | Readable baseline label. |
policyComparisonboolean · required | Whether comparison against a captured privacy policy was included. |
checkliststring | null · required | Company checklist label when selected; otherwise null. |
ReviewSummary
| Field | Description |
|---|---|
checksinteger · required | Selected checks in this review. |
passedinteger · required | Captured passing checks; reviewed warnings are not converted to passes. |
notApplicableinteger · required | Checks recorded as not applicable. |
warningsAcceptedinteger · required | Warnings accepted with documented explanations. |
warningsDisputedinteger · required | Warnings disputed with documented explanations. |
findingsClosedinteger · required | Findings closed with documented decisions. |
findingsRoadmappedinteger · required | Findings 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
| Status | Meaning |
|---|---|
active | Current review The original scoped review is still eligible. This is a dated review record, not a legal or security certification. |
revoked | Revoked The company revoked the record. Do not show it as currently verified. |
superseded | Newer watch exists A newer completed watch exists for the website. The old record is historical. |
evidence_expired | Evidence review due The source evidence is at least 30 days old; the historical review remains available. |
rule_review_due | Rule review due A verified mapped update may affect the reviewed scope and needs reassessment. |
review_changed | Review changed The source review changed or no longer meets issuance requirements. |
source_unavailable | Source unavailable The source watch cannot be retrieved. Current verification is unconfirmed. |
lookup_required | Directory entry only Returned by search. Retrieve the code to check its current status. |
HTTP responses
| Code | What to do |
|---|---|
200 | Request succeeded. For code lookups, inspect status; only active is current. An empty search is also a successful 200. |
400 | The search query is invalid. Supply 3–120 characters. |
404 | The record is missing, private, or the code is invalid. Do not infer verification or whether a private record exists. |
405 | The method is not supported. Use GET; the public API cannot modify records. |
429 | Verification is busy. Back off and respect Retry-After when it is present. |
503 | Verification is temporarily unavailable. Keep current verification unconfirmed and retry later. |
{
"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.
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.