API Documentation

The Identify API provides a unified interface to verify identities using document analysis, biometric matching, and sanctions screening — all in a single API call.

Overview

Base URL:

https://api.tech4life.pro/identify

All requests and responses use JSON. Include Content-Type: application/json in all requests.

Authentication

Authenticate using a Bearer token obtained from the login or register endpoints.

Authorization: Bearer <your_jwt_token>

POST /auth/register

Create a new account and receive a JWT token + API key.

Param	Type
`name`	string	required
`email`	string	required
`password`	string	required min 6 chars
`plan`	string	free \| starter \| pro \| enterprise

POST /auth/login

Param	Type
`email`	string	required
`password`	string	required

POST /identify/verify

Run the full identity verification pipeline: Document analysis + Biometric matching + Sanctions screening. Costs 1 credit.

Param	Type	Description
`doc_image`	string	required Base64-encoded document image (passport, ID card)
`face_image`	string	required Base64-encoded selfie/face photo
`consent`	boolean	required Must be true (LGPD/GDPR)
`purpose`	string	Optional. e.g. "kyc_onboarding"

curl -X POST https://api.tech4life.pro/identify/identify/verify \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "doc_image": "data:image/jpeg;base64,/9j/4AAQ...",
    "face_image": "data:image/jpeg;base64,/9j/4AAQ...",
    "consent": true,
    "purpose": "kyc_onboarding"
  }'

const res = await fetch('https://api.tech4life.pro/identify/identify/verify', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer ' + token
  },
  body: JSON.stringify({
    doc_image: docBase64,
    face_image: faceBase64,
    consent: true,
    purpose: 'kyc_onboarding'
  })
});
const data = await res.json();

import requests

res = requests.post(
    "https://api.tech4life.pro/identify/identify/verify",
    headers={
        "Content-Type": "application/json",
        "Authorization": f"Bearer {token}"
    },
    json={
        "doc_image": doc_base64,
        "face_image": face_base64,
        "consent": True,
        "purpose": "kyc_onboarding"
    }
)
data = res.json()

Response

{ "success": true, "data": { "ref": "IDN3A7F8C02", "decision": "APPROVED", "identity_level": 5, "document": { "verdict": "AUTHENTIC", "score": 92.5, "mrz_valid": true, "country": "BR", "name": "Joao Silva", "number": "AB123456" }, "biometric": { "decision": "APPROVED", "score": 0.91, "arcface": 0.89, "antispoof": 0.97 }, "sanctions": { "match": false, "score": 0, "label": "CLEAR" }, "risk_score": 0, "ms": 2340 } }

POST /biosignature/verify

Biometric-only verification. Compares a document photo against a selfie using ArcFace embeddings, 3D morphology (BFM), and anti-spoof detection.

Param	Type
`image1`	string	required Document face (base64)
`image2`	string	required Selfie (base64)
`consent`	boolean	required
`purpose`	string	required

POST /verifychain/check

AML/Sanctions screening. Screens an entity against 56,000+ sanctioned individuals, 15,000+ PEPs, and 18+ authoritative sources (OFAC, UN, EU, Interpol, FBI).

Param	Type
`name`	string	required Full entity name
`country`	string	ISO 2-letter code
`dob`	string	YYYY-MM-DD
`tier`	string	basic \| standard \| premium

GET /verifications/{ref}

GET /verifications/{ref_code}

Retrieve a previously completed verification result by its reference code.

Error Codes

Code	Meaning
200	Success
400	Bad request — missing or invalid parameters
401	Unauthorized — invalid or expired token
402	Insufficient credits
409	Email already registered
429	Rate limit exceeded
500	Internal server error

Rate Limits

300 requests per hour per IP address. Rate-limited responses return HTTP 429.

For higher limits, contact us at admin@tech4life.pro.

Identity Levels

Level	Requirements	Description
L1	Email verified	Basic registration
L2	L1 + BioSignature	Biometric verified
L3	L2 + National ID	National ID verified
L4	L2 + Passport (MRZ)	Passport verified
L5	L4 + AML Clear	Full KYC / AML clear