# Getting Started with iVALT Authentication APIs

Quick start guide for integrating iVALT's biometric authentication and identity verification into your application.

## Prerequisites

What You Need
- **API Key**: Your `x-api-key` from your iVALT account administrator
- **Base URL**: `https://api.ivalt.com/admin/public/api`


## Authentication

All API requests require the `x-api-key` header:


```http
x-api-key: YOUR_API_KEY
Content-Type: application/json
```

## Quick Start

### 1. Verify User

Verify a user's identity using their country code and mobile number.


```bash
POST /verify-user
```

**Request:**


```json
{
  "country_code": "+91",
  "mobile": "6283974746"
}
```

**Response:**


```json
{
  "status": "success",
  "message": "Verify user details with encryption"
}
```

### 2. Validate Global Authentication

Validate global authentication using the user's mobile number.


```bash
POST /validate/global/auth
```

**Request:**


```json
{
  "mobile": "+915558675309"
}
```

**Response:**


```json
{
  "status": "success",
  "message": "Validate global authentication"
}
```

## Complete Example

JavaScript

```javascript
const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://api.ivalt.com/admin/public/api';

const headers = {
  'x-api-key': API_KEY,
  'Content-Type': 'application/json'
};

// Step 1: Verify user
const verify = await fetch(`${BASE_URL}/verify-user`, {
  method: 'POST',
  headers,
  body: JSON.stringify({
    country_code: '+91',
    mobile: '5558675309'
  })
});

const verifyResult = await verify.json();

// Step 2: Validate global authentication
const validate = await fetch(`${BASE_URL}/validate/global/auth`, {
  method: 'POST',
  headers,
  body: JSON.stringify({
    mobile: '+915558675309'
  })
});

const validateResult = await validate.json();
```

cURL

```bash
# Verify user
curl -X POST "https://api.ivalt.com/admin/public/api/verify-user" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_code":"+91","mobile":"6283974746"}'

# Validate global authentication
curl -X POST "https://api.ivalt.com/admin/public/api/validate/global/auth" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mobile":"+916283974746"}'
```

## Next Steps

- View the complete [API Reference](/products/authentication/auth_apis)
- Explore [Admin Portal APIs](/products/admin-portal/admin_apis)
- Get help from the [AI Chat Assistant](/products/ai-features/chat-assistant)


Need Help?
- Visit **support.ivalt.com**
- Email **support@ivalt.com**
- Use the "Try It" console on any endpoint page