Certification API

The Certification API allows you to certify content as factually accurate, then retrieve certificates and badges for display on your website or in your app.

Overview

Content Certification proves your claims have been fact-checked by TruthVouch.

Use cases:

Display trust badges on product pages
Certify marketing claims before publishing
Submit batch content for compliance audits
Verify competitor claims in real-time

Key Endpoints

Submit Content for Certification

POST /api/v1/certifications/submit

curl -X POST https://api.truthvouch.com/api/v1/certifications/submit \
  -H "Authorization: Bearer tv_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Our product reduces latency by 50% compared to competitors",
    "contentType": "marketing_claim",
    "context": "Product landing page hero section",
    "metadata": {
      "campaign": "Q1-2024-launch",
      "region": "US"
    }
  }'

Response (201):

{
  "data": {
    "certificationId": "cert_abc123",
    "status": "pending",
    "trustScore": null,
    "claims": [],
    "expiresAt": "2025-03-15T00:00:00Z",
    "createdAt": "2024-03-15T10:30:00Z"
  }
}

Get Certification Status

GET /api/v1/certifications/{certificationId}

curl https://api.truthvouch.com/api/v1/certifications/cert_abc123 \
  -H "Authorization: Bearer tv_live_..."

Response:

{
  "data": {
    "certificationId": "cert_abc123",
    "status": "verified",
    "trustScore": 0.94,
    "claims": [
      {
        "claim": "Product reduces latency by 50%",
        "verified": true,
        "score": 0.94,
        "sources": ["source-1", "source-2"]
      }
    ],
    "badgeUrl": "https://badges.truthvouch.com/cert_abc123.png",
    "certificateUrl": "https://app.truthvouch.com/certificates/cert_abc123",
    "expiresAt": "2025-03-15T00:00:00Z"
  }
}

List Certifications

GET /api/v1/certifications

curl "https://api.truthvouch.com/api/v1/certifications?status=verified&page=1" \
  -H "Authorization: Bearer tv_live_..."

Revoke Certification

DELETE /api/v1/certifications/{certificationId}

curl -X DELETE https://api.truthvouch.com/api/v1/certifications/cert_abc123 \
  -H "Authorization: Bearer tv_live_..."

Batch Certification

Submit Batch

POST /api/v1/certifications/batch

curl -X POST https://api.truthvouch.com/api/v1/certifications/batch \
  -H "Authorization: Bearer tv_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "content": "Claim 1",
        "contentType": "marketing_claim"
      },
      {
        "content": "Claim 2",
        "contentType": "product_spec"
      }
    ],
    "callbackUrl": "https://yourapp.com/webhooks/certifications"
  }'

Get Batch Status

GET /api/v1/certifications/batch/{batchId}

curl https://api.truthvouch.com/api/v1/certifications/batch/batch_xyz \
  -H "Authorization: Bearer tv_live_..."

Displaying Badges

Once a certification is verified, display the trust badge:

HTML/CSS

<div class="truthvouch-badge">
  <img
    src="https://badges.truthvouch.com/cert_abc123.png"
    alt="TruthVouch Certified"
    style="max-width: 200px; cursor: pointer;"
    onclick="window.open('https://app.truthvouch.com/certificates/cert_abc123', '_blank')"
  />
</div>

React Component

function CertificationBadge({ certificationId }) {
  const badgeUrl = `https://badges.truthvouch.com/${certificationId}.png`;
  const certUrl = `https://app.truthvouch.com/certificates/${certificationId}`;

  return (
    <a href={certUrl} target="_blank" rel="noreferrer">
      <img
        src={badgeUrl}
        alt="TruthVouch Certified"
        style={{ maxWidth: '200px' }}
      />
    </a>
  );
}

Certification Lifecycle

Submit — Content sent for verification
Pending — Awaiting fact-check
Verified — Claims validated, trust score calculated
Expired — Certification older than 1 year (can renew)
Revoked — Manually revoked or challenged

Expiration

Certifications valid for: 1 year from issue date
Renewal: Resubmit content within 30 days of expiry
After expiry: Badge no longer displayed, certificate marked expired

Status Codes

Status	Meaning
`pending`	Awaiting fact-check (usually < 24 hours)
`verified`	Content is certified accurate
`disputed`	Community flagged certification for review
`revoked`	Certification manually revoked
`expired`	Older than 1 year

Pricing

Certifications: $0.10 per claim verified
Batch: $0.08 per claim (50+ claims)
Monthly: Unlimited for Enterprise plans