API Reference

Complete API documentation for integrating Verity video verification into your applications.

Authentication

Verity uses wallet-based authentication. Users connect their MetaMask or compatible Web3 wallet.

// Connect wallet
const accounts = await window.ethereum.request({ 
  method: 'eth_requestAccounts' 
});

Video Upload

Upload and verify videos with automatic blockchain deployment.

POST /api/videos/upload
Content-Type: multipart/form-data

Form Data:
- video: File (required)
- creator: string (wallet address)
- metadata: JSON string
- aiAnalysis: JSON string
- witnesses: JSON string

Response:
{
  "verificationId": "uuid",
  "videoHash": "sha256-hash",
  "blockchainTx": "0x...",
  "videoUrl": "/uploads/..."
}

Verification

Verify videos by ID or hash, or upload a file to check.

GET /api/verification/:identifier

Response:
{
  "verified": true,
  "video": {
    "verificationId": "uuid",
    "videoHash": "sha256-hash",
    "blockchainTx": "0x...",
    "aiScore": 95
  }
}

Base URL

https://verityapp.live/api