API Reference

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.

Header	Description
`Authorization`	Bearer token with your API key
`X-CLIENT-ID`	Your application’s client ID

API Endpoints Overview

Verification

Method	Endpoint	Description
`POST`	`/verifications`	Start a new verification
`GET`	`/verifications/{id}/status`	Get verification status
`POST`	`/verifications/{id}/send-inputs`	Submit verification inputs
`POST`	`/verifications/{id}/validations/{processType}`	Validate inputs before submission

Workflow

Method	Endpoint	Description
`GET`	`/workflows/supported-document-types`	Get all supported document types
`GET`	`/workflows/{id}/document-types`	Get document types for a workflow
`POST`	`/workflows/{id}/email-otp`	Send email OTP

Webhook

Method	Endpoint	Description
`POST`	`/webhooks/configure`	Configure a webhook endpoint

Error Handling

The API uses standard HTTP status codes:

Status Code	Description
`200`	Success
`201`	Created
`204`	No Content (success, no body)
`400`	Bad Request - invalid input
`401`	Unauthorized - invalid API key
`403`	Forbidden - insufficient permissions
`404`	Not Found
`429`	Rate 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

Email: support@urtentic.com
Status Page: status.urtentic.com

Overview

Verification

Workflows

Webhooks

Base URL

Authentication

API Endpoints Overview

Verification

Workflow

Webhook

Error Handling

Rate Limits

Support

​Base URL

​Authentication

​API Endpoints Overview

​Verification

​Workflow

​Webhook

​Error Handling

​Rate Limits

​Support

Base URL

Authentication

API Endpoints Overview

Verification

Workflow

Webhook

Error Handling

Rate Limits

Support