← Back to Documentation

REST API Reference

Complete API documentation for Veriafy integration

Base URL

https://api.veriafy.com/v1

For self-hosted deployments, replace with your server URL.

Authentication

All API requests require authentication via API key in the header:

Authorization: Bearer sk-your-api-key

Endpoints

POST/classify

Classify a file using a Veriafy model.

Request Body

{
  "file": "base64-encoded-file-content",
  "model": "veriafy/nsfw-classifier",
  "threshold": 0.5
}

Response

{
  "success": true,
  "data": {
    "vector_id": "v_abc123def456",
    "categories": { "safe": 0.98, "explicit": 0.02 },
    "confidence": 0.98,
    "action": "allow"
  }
}
POST/classify/batch

Classify multiple files in a single request.

POST/extract

Extract Veriafy Vector without classification.

GET/models

List available models.

GET/health

Check API health status.

Error Codes

CodeDescription
400Bad request - invalid parameters
401Unauthorized - invalid API key
429Rate limit exceeded
500Internal server error

Rate Limits

PlanRequests/min
Free60
Pro300
EnterpriseCustom

Next Steps

Python SDKTypeScript SDK
Veriafy - Universal File Classification Platform