Brainiac Seal Verification API

Version 1.1

The Open Attestation Layer. All endpoints are public. Read endpoints require no authentication. All responses include CORS headers.

ISSUER
Brainiac Ltd
thomas@brainiaclimited.com
167-169 Great Portland Street, London, W1W 5PF - Registered in England and Wales

Endpoints

embeddable badge

GET
/badge?hash=HASH&size=medium

Returns an SVG badge with operator tier and score. Can be embedded on any website.

PARAMETERS
NameTypeRequiredDescription
hashstringYes64-character SHA-256 hash
sizestringNosmall, medium (default), or large

seal verification

POST
/verifyAuditSeal

Verify a seal by hash. Returns tier, score, domain breakdown, and verification count.

PARAMETERS
NameTypeRequiredDescription
hashstringYes64-character SHA-256 hash

public registry

GET
/getPublicRegistry

Returns all public, non-revoked seals with hash, tier, score, date, and verify URL. Anonymized.

methodology

GET
/getMethodology

Full assessment methodology: weights, tiers, countermeasures, and framework mapping. Publicly published.

framework mapping

GET
/getFrameworkMapping

Maps 30 questions and 8 domains to EU AI Act 14(4)(a)-(e), NIST AI RMF, and ISO 42001.

benchmarks

GET
/getBenchmarks

Aggregated anonymized benchmarks by industry. Optional market filter.

PARAMETERS
NameTypeRequiredDescription
marketstringNoIndustry filter, e.g. 'Financial Services'

verification log

GET
/getVerificationLog?hash=HASH

Full verification log with SHA-256 hash chain for tamper protection.

PARAMETERS
NameTypeRequiredDescription
hashstringYes64-character SHA-256 hash

json ld

GET
/getSealJSONLD?hash=HASH

JSON-LD structured data for search engine indexing.

PARAMETERS
NameTypeRequiredDescription
hashstringYes64-character SHA-256 hash

certificate

GET
/getSealCertificate?hash=HASH

Full certificate with assessment details and Article 14 mapping.

PARAMETERS
NameTypeRequiredDescription
hashstringYes64-character SHA-256 hash

article 14 assessment

GET
/getArticle14Assessment?hash=HASH

Article 14(4)(a)-(e) compliance breakdown for a specific seal.

PARAMETERS
NameTypeRequiredDescription
hashstringYes64-character SHA-256 hash

seal revocation

POST
/revokeSeal

Revoke a seal. Requires authentication. Revoked seals remain in the registry but are marked as revoked.

PARAMETERS
NameTypeRequiredDescription
hashstringYes64-character SHA-256 hash
reasonstringYesRevocation reason

tamper demo

GET
/tamperDemo

Interactive demonstration of hash chain tamper detection. Shows what happens when an audit entry is modified.

health check

GET
/healthCheck

System health check. Returns status of all backend services.

audit trail

GET
/getAuditTrail

Admin audit trail of all seal operations.

webhook management

POST
/manageWebhooks

Manage webhook subscriptions for compliance events. HMAC-signed payloads.

PARAMETERS
NameTypeRequiredDescription
actionstringYeslist, create, delete, or test
urlstringNoWebhook URL (for create)
eventsarrayNoEvent types to subscribe to

api key creation

POST
/createApiKey

Create a new API key for platform access. Returns key with 1,000 calls/day rate limit.

PARAMETERS
NameTypeRequiredDescription
organization_namestringYesOrganization name
scopesarrayNoAllowed scopes: verify, batch_verify, audit_trail, gdpr_export

batch verification

POST
/batchVerifySeals

Batch verify up to 500 seals at once. Returns verification status for each hash.

PARAMETERS
NameTypeRequiredDescription
hashesarrayYesArray of SHA-256 hashes (max 500)

api key validation

POST
/validateApiKey

Validate an API key and check permissions.

PARAMETERS
NameTypeRequiredDescription
api_keystringYesAPI key to validate

gdpr export

POST
/gdprExport

GDPR Article 20 - Right to data portability. Export all personal data.

PARAMETERS
NameTypeRequiredDescription
emailstringYesEmail of the data subject

gdpr deletion

POST
/gdprDelete

GDPR Article 17 - Right to erasure. Permanently delete all personal data.

PARAMETERS
NameTypeRequiredDescription
emailstringYesEmail of the data subject
confirmbooleanYesConfirm deletion (must be true)

witness engine

POST
/witnessEngine

Triple AI cross-verification. Three independent model families from three different providers (xAI, Alibaba, Google) assess the same target. Returns convergence assessment with SHA-256 seal.

PARAMETERS
NameTypeRequiredDescription
target_urlstringYesURL of the company website to assess
company_namestringYesCompany name

stripe webhook

POST
/stripeWebhookHandler

Stripe webhook handler for payment processing. Internal endpoint.

PARAMETERS
NameTypeRequiredDescription
stripe_signaturestringYesStripe signature header

Seal Validity

12 months from assessment date

Seal expires 12 months from issue date. Expired seals remain in the public registry but are marked as expired.

Re-assessment required annually to maintain active status. A new assessment generates a new seal with a fresh hash.

Audit Log

Type: SHA-256 Hash Chain

Every seal verification is permanently logged with a timestamp and hash. Each entry cryptographically links to the previous entry, creating a tamper-evident chain. Any modification breaks the chain visibly.

Chain algorithm:

currentHash = SHA-256(prevHash + timestamp + sealHash + entryType + salt)

Genesis: GENESIS (hardcoded initial hash, never changes)

SDK

A lightweight SDK for integrating with your stack. Works in browser and Node.js. No dependencies.

import AuditProofClient from 'auditproof-sdk';

const client = new AuditProofClient('your_api_key');

// Verify a seal
const result = await client.verifySeal('6f21cc8c...');

// Batch verify
const batch = await client.batchVerify(['hash1', 'hash2']);

// Get registry
const registry = await client.getRegistry();

// Get badge SVG
const badge = await client.getBadge('6f21cc8c...', 'medium');

// Get QR code
const qr = await client.getQR('6f21cc8c...', 'svg');

// Get PDF certificate
const pdf = await client.getCertificatePdf('6f21cc8c...', 'en');

// Check renewal
const renewal = await client.checkRenewal('6f21cc8c...');
Download SDK
MIT License. (c) 2026 Brainiac Ltd.
LEGAL DISCLAIMER

Proof of Operator provides independent operator capability assessments. The seal constitutes evidence that an assessment was conducted by Brainiac Ltd. It is not a legal certification of compliance with EU Regulation 2024/1689 or any other regulation. Brainiac Ltd is not liable for regulatory decisions based on the seal. Companies should consult their own legal counsel regarding their specific regulatory obligations.

Proof of Operator provides independent operator capability assessments. The seal constitutes evidence that an assessment was conducted by Brainiac Ltd. It is not a legal certification of compliance with EU Regulation 2024/1689 or any other regulation. Brainiac Ltd is not liable for regulatory decisions based on the seal. Companies should consult their own legal counsel regarding their specific regulatory obligations.