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

bash
# Set your sandbox key (create one at
# https://verify.switchlabs.dev/login?mode=signup)
export VERIFY_AI_API_KEY=vai_your_api_key

2. Use

bash
# 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.

Get in Touch

Questions about pricing, integrations, or custom deployments? We'd love to hear from you.