VerifyAI REST API
Integrate AI-powered photo verification into any application using standard HTTP requests. Language-agnostic, fully documented, with webhook support for async results.
Quick Start
1. Install
# Authenticate with your API key
curl https://api.verifyai.dev/v1/health \
-H "Authorization: Bearer vi_live_..."2. Use
# Submit a photo for verification
curl -X POST https://api.verifyai.dev/v1/verify \
-H "Authorization: Bearer vi_live_..." \
-H "Content-Type: application/json" \
-d '{
"image": "data:image/jpeg;base64,/9j/4AAQ...",
"policy": "scooter_parking",
"metadata": {
"vehicleId": "VH-1234"
}
}'
# Response
# {
# "verificationId": "ver_abc123",
# "isCompliant": true,
# "confidence": 0.97,
# "processingTimeMs": 340
# }Features
Language Agnostic
Standard REST endpoints work with any programming language or HTTP client. No SDK required.
Webhook Callbacks
Receive verification results asynchronously via webhook. Configure retry policies and signing secrets.
Base64 & URL Upload
Submit images as base64-encoded strings or provide a URL for VerifyAI to fetch. Support for JPEG, PNG, and WebP.
Batch Processing
Submit up to 50 images in a single request for bulk verification. Ideal for fleet inspections and audits.
Rate Limiting & Quotas
Transparent rate limits with headers showing remaining quota. Burst support for high-traffic applications.
Signed Webhooks
All webhook payloads are signed with HMAC-SHA256. Verify authenticity before processing results.
Code Examples
Requirements
- VerifyAI API key (free sandbox available)
- HTTP client capable of sending JSON requests
- Images in JPEG, PNG, or WebP format (max 20MB)
- HTTPS endpoint for webhook callbacks (optional)
Frequently Asked Questions
Start Using the REST API
Get your free API key and send your first verification request in seconds.