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
# Set your sandbox key (create one at
# https://verify.switchlabs.dev/login?mode=signup)
export VERIFY_AI_API_KEY=vai_your_api_key2. Use
# Submit a photo for verification (multipart is easiest for a local file)
curl -X POST https://verify.switchlabs.dev/api/v1/verify \
-H "X-API-Key: $VERIFY_AI_API_KEY" \
-F "image=@scooter.jpg" \
-F "policy=scooter_parking" \
-F 'metadata={"vehicle_id":"VH-1234"}'
# Response
# {
# "id": "ver_8x92m4k9",
# "created_at": "2026-05-12T14:30:00Z",
# "status": "success",
# "is_compliant": true,
# "confidence": 0.97,
# "policy": "scooter_parking",
# "violation_reasons": [],
# "feedback": "Scooter is upright inside the bay and clear of the walkway."
# }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, Multipart & URL Upload
Post the file directly as multipart/form-data, send a base64 string (raw or as a data URL) in a JSON body, 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.
Safe Retries
Send an Idempotency-Key header and an identical retry returns the cached response instead of verifying, and billing, a second time.
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, keys start with vai_)
- HTTP client capable of sending multipart/form-data or JSON requests
- Images in JPEG, PNG, or WebP format (max 10MB)
- 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.
Other ways to integrate
Native SDKs, server libraries, the REST API, webhooks, and no-code automation platforms.