API Reference - Urtentic Documentation

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}/otp`	Send an email or SMS one-time code

Webhooks

Webhook URLs and secrets are set in the dashboard, not through the API. See Webhook configuration.

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
`402`	Payment Required - the organization’s plan or credits can’t pay for this. See Billing and usage
`403`	Forbidden - insufficient permissions
`404`	Not Found
`429`	Rate Limited

Error responses include a JSON body. Branch on code, which is stable. message is either a readable sentence or a message key such as verification.not.found. For validation errors, errors lists a message per invalid field.

{
  "code": "VERIFICATION_NOT_FOUND",
  "message": "verification.not.found",
  "errors": []
}

A 401 from a missing or invalid API key has no body.

Rate limits

Limits are per client IP address. Going over a limit returns 429 with the code RATE_LIMIT_EXCEEDED.

Endpoint	Limit
`POST /verifications/{id}/send-inputs`	20 requests per minute
`POST /verifications/{id}/validations/{processType}`	20 requests per minute
`POST /workflows/{id}/otp`	5 SMS codes per verification (`SMS_LIMIT_REACHED`). Email codes have no limit.

A webhook event is retried up to 5 times over about 10 minutes when your server responds with 5xx or 429, or doesn’t respond within 30 seconds. Any other 4xx drops it straight away. See Delivery and retries.

Support

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

​Base URL

​Authentication

​API Endpoints Overview

​Verification

​Workflow

​Webhooks

​Error Handling

​Rate limits

​Support

Base URL

Authentication

API Endpoints Overview

Verification

Workflow

Webhooks

Error Handling

Rate limits

Support