Veredict API
Integrate military-grade AI detection into your LMS, CMS, or hiring platform via a simple REST interface.
Developer Access
Authenticate to generate your secret keys.
Live Credentials
This key grants programmatic access to your credit balance.
Endpoint Reference
Detection Request
cURL Example (Text Detection)
curl -X POST https://veredictlabs.com/api/v1/detect \
-H "Authorization: Bearer sk_vd_..." \
-H "Content-Type: application/json" \
-d '{
"text": "The quick brown fox jumps over the lazy dog."
}'
cURL Example (Document Upload - PDF, DOCX, TXT)
curl -X POST https://veredictlabs.com/api/v1/detect \
-H "Authorization: Bearer sk_vd_..." \
-H "Content-Type: application/json" \
-d '{
"file_base64": "VGhlIHF1aWNrIGJyb3duIGZveCBqdW1wcyBvdmVyIHRoZSBsYXp5IGRvZy4=",
"filename": "document.docx"
}'
JSON Response Schema
{
"scan_id": 12345, // Unique ID for this scan
"report_url": "https://api.veredictlabs.com/report/12345", // Shareable Report
"score_human": 98.5, // 0-100 Confidence
"score_ai": 1.5, // Inverse of human score
"verdict": "Human", // Human | AI
"metrics": {
"detector_confidence": 0.98,
"rhythm_variance": 12.1,
"vector_similarity": 0.15
},
"sentences": [
{
"text": "The quick brown fox jumps over the lazy dog.",
"ai_score": 0.01
}
],
"robotic_phrases": []
}
Shareable Reports
Every successful detection returns a report_url. You can surface this URL directly to your users to provide them with a beautiful, readable report covering the AI detection breakdown, sentence-level analysis, and key metrics. Users can save these reports as PDFs by clicking the "Print to PDF" button on the report page.
Rate Limits
Free: 5 req/min
Pro: 60 req/min
Enterprise: Unlimited
Error Codes
401: Invalid API Key
402: Insufficient Credits
422: Text too short (<50 chars)