API Reference

Authorization: Bearer sbix_live_xxxxxxxxxxxxxxxx

sbix_live_<64 hex characters>

Example:
sbix_live_7efbd6230039b2dd745b1c4334ef1713a770f245204476a5b881eef0b32c4fc6

curl -X POST https://certify.sbix.io/api/v1/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@artwork.png"

{
  "success": true,
  "data": {
    "origin": {
      "proof_id": "teia_127061",
      "platform": "teia",
      "first_seen": "2021-03-12T00:00:00Z",
      "origin_score": 0.73,
      "confidence": 73,
      "decision": "LIKELY_ORIGINAL",
      "source_url": "https://ipfs.io/ipfs/QmPrW..."
    },
    "copies_detected": 17,
    "trust_index": 62,
    "db_size": 5500000,
    "checked_at": "2026-03-31T15:00:00Z"
  }
}

{
  "success": true,
  "data": {
    "origin": null,
    "copies_detected": 0,
    "trust_index": 0,
    "db_size": 5500000,
    "checked_at": "2026-03-31T15:00:00Z"
  }
}

curl -X POST https://certify.sbix.io/api/v1/check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@artwork.png"

curl -X POST https://certify.sbix.io/api/v1/check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://ipfs.io/ipfs/QmXxx..."}'

{
  "success": true,
  "data": {
    "decision": "BLOCK",
    "verdict": "STRONG_COPY",
    "alert": "COPY",
    "confidence": 100,
    "risk": "high",
    "trust_index": 25,
    "decision_reason": "copy_verifier confirmed_copy (401 inliers, ir=0.98)",
    "best_match": {
      "proof_id": "teia_837192",
      "platform": "teia",
      "distance": 9,
      "similarity_percent": 89.1,
      "match_via": "original",
      "retrieval_lane": "vrc",
      "source_url": "https://ipfs.io/ipfs/QmS9fXRz3SEVqpLib4LYFWJS3GxhBLFJU6J5sWJXmWNkVA",
      "first_indexed_at": "2022-06-14T10:00:00Z"
    },
    "verification_summary": {
      "decision": "confirmed_copy",
      "score": 100.0,
      "transform": "original"
    },
    "origin": null,
    "copies_detected": 3,
    "db_size": 5500000,
    "checked_at": "2026-03-31T15:00:00Z"
  }
}

{
  "success": true,
  "data": {
    "decision": "SAFE",
    "verdict": "ORIGINAL_LIKELY",
    "alert": "CLEAN",
    "confidence": 95,
    "risk": "none",
    "trust_index": 44,
    "decision_reason": "no significant match found",
    "best_match": null,
    "origin": null,
    "copies_detected": 0,
    "db_size": 5500000,
    "checked_at": "2026-03-31T15:00:00Z"
  }
}

async function checkBeforeListing(imageFile) {
  const formData = new FormData();
  formData.append('file', imageFile);

  const res = await fetch('https://certify.sbix.io/api/v1/check', {
    method: 'POST',
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
    body: formData
  });

  const { data } = await res.json();

  if (data.decision === 'BLOCK') {
    return { action: 'block', reason: data.verdict, match: data.best_match };
  }
  if (data.decision === 'REVIEW') {
    return { action: 'review', confidence: data.confidence };
  }
  return { action: 'allow' };
}

curl -X POST https://certify.sbix.io/api/v1/ingest \
  -H "Authorization: Bearer YOUR_PARTNER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "asset_id": "getty_123456789",
    "image_url": "https://media.gettyimages.com/photos/123456789.jpg",
    "platform": "getty",
    "first_seen_at": "2020-01-15T10:00:00Z"
  }'

{
  "success": true,
  "status": "indexed",
  "proof_id": "getty_123456789",
  "message": "Asset fingerprinted and indexed successfully"
}

{
  "success": true,
  "status": "already_indexed",
  "proof_id": "getty_123456789",
  "message": "Asset already in index"
}

curl -X POST https://certify.sbix.io/api/certify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "leaves": ["e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"],
    "filename": "artwork_original.png",
    "leaves_hashed": true
  }'

{
  "message": "Proof successfully generated",
  "proof_id": "proof_9cec4ed9a95e4ed8",
  "merkle_root": "6e8f29ea62064465c81ff096609953345a8475f0cb53324833e7ea7a0604593f",
  "timestamp": "2026-03-01T13:24:55.348703Z",
  "tsa_type": "eIDAS Qualified",
  "tsa_provider": "AlfaSign (AlfaTrust Certification S.A.)",
  "eidas_qualified": true,
  "verify_url": "https://certify.sbix.io/verify/proof_9cec4ed9a95e4ed8"
}

import requests, hashlib

API_KEY = "sbix_live_your_key_here"

with open("artwork.png", "rb") as f:
    file_hash = hashlib.sha256(f.read()).hexdigest()

response = requests.post(
    "https://certify.sbix.io/api/certify",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"leaves": [file_hash], "filename": "artwork.png", "leaves_hashed": True}
)

result = response.json()
print(f"Proof ID: {result['proof_id']}")
print(f"Verify:   {result['verify_url']}")

curl https://certify.sbix.io/api/proof/proof_9cec4ed9a95e4ed8 \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -o evidence_pack.zip \
  https://certify.sbix.io/api/v1/certificates/proof_9cec4ed9a95e4ed8/evidence-pack \
  -H "Authorization: Bearer YOUR_API_KEY"

https://certify.sbix.io/verify/proof_bb0593e0d35c434f

openssl ts -verify -in timestamp.tsr -data proof.json

sha256sum -c sha256sums.txt

{
  "error": "bad_request",
  "reason": "Description of the problem"
}