---
title: API Integration Guide
slug: one-touch-kyc/api-integration-guide
createdAt: 2026-07-29T07:47:26.381Z
---

# One Touch KYC

One Touch KYC lets you verify a user's identity by sending them a hosted verification link
(a **Journey**), built from a **Flow** you configure once in your dashboard. This reference
covers the three things you need to integrate:

1. **Create a Journey** — generate a hosted verification link for an end user.
2. **Get a Journey** — retrieve the status and results of a verification.
3. **Callbacks** — get notified automatically the moment a verification finishes.

If you just want to explore the product hands-on first, see the companion
[User Guide](https://docs.signzy.com/one-touch-kyc/user-guide).

***

## Getting started

1. Log in to your OTKYC dashboard.
2. Go to **Settings → Team → API Keys** and click **Generate API Key**. Copy it somewhere safe and secure.
3. Go to **Settings → Callback config** and set the URL you want journey results delivered to (optional, but recommended — see Callbacks section).
4. Build at least one **Flow** in the **Flows** tab (which documents to accept, which checks to run, your branding). You'll need its Flow ID for every journey you create.

You're now ready to call the API.

## Base URL Endpoints

### Preproduction

```curl
https://onetouch-preproduction.signzy.app/
```

### Production

:::CodeblockTabs
Global Environment

```curl
https://onetouch.signzy.app/
```
:::

:::CodeblockTabs
US Environment

```curl
https://onetouch.signzy.us/
```
:::

:::CodeblockTabs
UAE Environment

```curl
https://onetouch.signzy.ae/
```
:::

:::CodeblockTabs
Canada Environment

```curl
https://onetouch.signzy.ca/
```
:::

## Authentication

Every API call must include your API key, we support either x-api-key or Authorization in the header, pass any one of them:

```none
x-api-key: <your-api-key>
```

or

```none
Authorization: <your-api-key>
```

Requests without a valid key, or with a revoked key, receive `401 Unauthorized`. You can
generate, copy, or revoke keys at any time from **Settings → Team → API Keys** — revoking a key takes effect immediately, so make sure any running integration is updated before you revoke the old one.

***

## What's next?

- [Create Journey API](https://docs.signzy.com/one-touch-kyc/create-journey-api) — Generates a hosted verification link tied to a specific Flow.
- [Get Journey API](https://docs.signzy.com/one-touch-kyc/get-journey-api)  — Retrieves the current status and captured results of a journey.
- [User Guide](https://docs.signzy.com/one-touch-kyc/user-guide) — how to build Flows, manage Journeys, and configure your account from the dashboard.
- **Questions or issues integrating:** contact our Signzy Account/Support team.
