> ## Documentation Index
> Fetch the complete documentation index at: https://docs.urtentic.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> Complete API documentation for the Urtentic identity verification platform.

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:

```bash theme={null}
Authorization: Bearer {API_KEY}
X-CLIENT-ID: {CLIENT_ID}
```

<Info>
  API credentials can be generated from your [Urtentic Dashboard](https://app.urtentic.com) under the Integrations page.
</Info>

| 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:

```json theme={null}
{
  "error": "INVALID_WORKFLOW",
  "message": "The specified workflow ID is invalid or not found"
}
```

## Rate Limits

<Warning>
  * OTP requests: Maximum 5 per email address per hour
  * Webhook deliveries timeout after 10 seconds
</Warning>

## Support

* **Email**: [support@urtentic.com](mailto:support@urtentic.com)
* **Status Page**: [status.urtentic.com](https://status.urtentic.com)