Authenta API Overview
Authenta provides a secure, scalable API that allows customers to integrate deepfake-detection capabilities directly into their own applications and services.
With API access, you can programmatically upload media, check analysis results, and manage previously processed items using authenticated API calls.
The Authenta API is designed for organizations that require automated or large-scale media validation workflows beyond what is available in the Authenta web console.
Why Use the Authenta API?
Authenta’s API enables you to:
- Automate deepfake detection pipelines in your internal systems
- Upload media programmatically for evaluation
- Fetch results and metadata without using the UI
- Integrate trust & safety checks directly into your product
- Manage media lifecycle (upload, fetch, delete)
The API uses the same detection engine and produces the same results as the Authenta platform—just accessible via secure endpoints.
Quick Start
Getting started with the API is simple:
- Navigate to Settings → API Keys in your Authenta Console
- Click Create API Key
- Configure your key name and permissions
- Copy your API key immediately and store it securely
- Start making authenticated API calls
Authentication Model
All API calls require one header:
Authorization: Bearer api_xxxxxxxx...Your API key uniquely identifies and authenticates your requests. The API key is shown only once, so make sure to store it securely.
Authenta uses a simple bearer token authentication system.
Permissions
Each API key carries one or more permissions:
| Permission | Lets the key |
|---|---|
| Read | List jobs, read results and download files |
| Write | Create and finalize jobs |
| Delete | Cancel and delete jobs |
See Managing API Keys for details.
Credits
Authenta bills media analysis in credits, shared between the web console and the API:
- Each job's cost depends on its task type (per page for PDFs, per enabled check for face intelligence) and is charged when the job is created
- Cancelled jobs, and jobs that fail, are refunded automatically
- Reading, listing and deleting jobs is free
See Quotas & Credits for pricing and refund rules.
OpenAPI specification
The full API is described in an OpenAPI 3 spec: authenta-api.yaml. Import it into Postman or any OpenAPI tool, generate a typed client from it, or try the requests in the API Explorer.
Supported API Endpoints
The current set of public API routes includes:
- POST
/api/v1/jobs: Create a job and get upload URLs (Write) - POST
/api/v1/jobs/{id}/finalize: Queue the job for processing (Write) - GET
/api/v1/jobs: List jobs (Read) - GET
/api/v1/jobs/{id}: Get a job with its result and files (Read) - POST
/api/v1/jobs/{id}/cancel: Cancel a job (Delete) - DELETE
/api/v1/jobs/{id}: Delete a job (Delete)
Full details are available in Jobs API References
Task Types
Each job runs one detection model, called a task type: AI image, audio and video detection, image and document forgery, face liveness, eKYC deepfake detection, PDF tampering, and a few utilities. Task Types lists them all and explains how to read results, which works the same for every detector.
Next Steps
To begin integrating the API:
- Create an API key (no approval needed)
- Learn how authentication works
- Pick a task type
- Run your first job
Authenta’s API enables powerful automated trust-analysis workflows, and this section of the documentation will guide you through each step of the integration.
