Skip to main content
The Urtentic API provides comprehensive identity verification and workflow management capabilities. It enables organizations to create customized verification workflows, perform identity checks, and manage verification processes.

​
Base URL

https://api.urtentic.com/api/v1

​
Authentication

All authenticated endpoints require two headers: 
Authorization: Bearer {API_KEY}
X-CLIENT-ID: {CLIENT_ID}
API credentials can be generated from your Urtentic Dashboard under the Integrations page.
HeaderDescription
AuthorizationBearer token with your API key
X-CLIENT-IDYour application’s client ID

​
API Endpoints Overview

​
Verification

MethodEndpointDescription
POST/verificationsStart a new verification
GET/verifications/{id}/statusGet verification status
POST/verifications/{id}/send-inputsSubmit verification inputs
POST/verifications/{id}/validations/{processType}Validate inputs before submission

​
Workflow

MethodEndpointDescription
GET/workflows/supported-document-typesGet all supported document types
GET/workflows/{id}/document-typesGet document types for a workflow
POST/workflows/{id}/email-otpSend email OTP

​
Webhook

MethodEndpointDescription
POST/webhooks/configureConfigure a webhook endpoint

​
Error Handling

The API uses standard HTTP status codes:
Status CodeDescription
200Success
201Created
204No Content (success, no body)
400Bad Request - invalid input
401Unauthorized - invalid API key
403Forbidden - insufficient permissions
404Not Found
429Rate Limited
Error responses include a JSON body: 
{
  "error": "INVALID_WORKFLOW",
  "message": "The specified workflow ID is invalid or not found"
}

​
Rate Limits

  • OTP requests: Maximum 5 per email address per hour
  • Webhook deliveries timeout after 10 seconds

​
Support