Identity Verification API

curl -X POST https://api.kycgenie.com/api/v1/verification/sessions/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "entity_id": "550e8400-e29b-41d4-a716-446655440000",
    "email": "john.doe@example.com",
    "verification_profile": "standard",
    "expiry_hours": 48,
    "send_email": true
  }'

curl -X POST https://api.kycgenie.com/api/v2/verification/sessions/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "entity_id": "550e8400-e29b-41d4-a716-446655440000",
    "email": "john.doe@example.com",
    "verification_profile": "standard",
    "expiry_hours": 48,
    "send_email": true
  }'

import requests
import uuid

response = requests.post(
    "https://api.kycgenie.com/api/v1/verification/sessions/",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "entity_id": "550e8400-e29b-41d4-a716-446655440000",
        "email": "john.doe@example.com",
        "verification_profile": "standard",
        "expiry_hours": 48,
        "send_email": True,
    }
)
print(response.json())

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

session = client.identity_verification.create(
    entity_id="550e8400-e29b-41d4-a716-446655440000",
    email="john.doe@example.com",
    verification_profile="standard",
    expiry_hours=48,
    send_email=True,
)

print(session.session_id)
print(session.status)      # "pending"
print(session.email_sent)  # True

const response = await fetch(
  "https://api.kycgenie.com/api/v1/verification/sessions/",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
      "Idempotency-Key": crypto.randomUUID(),
    },
    body: JSON.stringify({
      entity_id: "550e8400-e29b-41d4-a716-446655440000",
      email: "john.doe@example.com",
      verification_profile: "standard",
      expiry_hours: 48,
      send_email: true,
    }),
  }
);
const data = await response.json();

const response = await fetch(
  "https://api.kycgenie.com/api/v2/verification/sessions/",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
      "Idempotency-Key": crypto.randomUUID(),
    },
    body: JSON.stringify({
      entity_id: "550e8400-e29b-41d4-a716-446655440000",
      email: "john.doe@example.com",
      verification_profile: "standard",
      expiry_hours: 48,
      send_email: true,
    }),
  }
);
const data = await response.json();

curl https://api.kycgenie.com/api/v1/verification/sessions/770e8400-e29b-41d4-a716-446655440002/ \
  -H "Authorization: Bearer YOUR_API_KEY"

curl https://api.kycgenie.com/api/v2/verification/sessions/770e8400-e29b-41d4-a716-446655440002/ \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.kycgenie.com/api/v1/verification/sessions/770e8400-e29b-41d4-a716-446655440002/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

session = client.identity_verification.get_session(
    session_id="770e8400-e29b-41d4-a716-446655440002",
)

print(session.status)          # "completed"
print(session.outcome)         # "clear"
print(len(session.checks))     # 2

const response = await fetch(
  "https://api.kycgenie.com/api/v1/verification/sessions/770e8400-e29b-41d4-a716-446655440002/",
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);
const data = await response.json();
console.log(data.status, data.outcome);

const response = await fetch(
  "https://api.kycgenie.com/api/v2/verification/sessions/770e8400-e29b-41d4-a716-446655440002/",
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);
const data = await response.json();
console.log(data.status, data.outcome);

curl https://api.kycgenie.com/api/v1/verification/sessions/770e8400-e29b-41d4-a716-446655440002/results/ \
  -H "Authorization: Bearer YOUR_API_KEY"

curl https://api.kycgenie.com/api/v2/verification/sessions/770e8400-e29b-41d4-a716-446655440002/results/ \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.kycgenie.com/api/v1/verification/sessions/770e8400-e29b-41d4-a716-446655440002/results/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

results = client.identity_verification.get_results(
    session_id="770e8400-e29b-41d4-a716-446655440002",
)

data = results.extracted_data
print(data.first_name, data.last_name)
print(data.document_type, data.document_number)

for check in results.checks:
    print(check.check_type, check.outcome)

const response = await fetch(
  "https://api.kycgenie.com/api/v1/verification/sessions/770e8400-e29b-41d4-a716-446655440002/results/",
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);
const data = await response.json();

const response = await fetch(
  "https://api.kycgenie.com/api/v2/verification/sessions/770e8400-e29b-41d4-a716-446655440002/results/",
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);
const data = await response.json();

curl -X POST https://api.kycgenie.com/api/v1/verification/sessions/770e8400-e29b-41d4-a716-446655440002/resend/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"email": "john.doe.work@example.com"}'

curl -X POST https://api.kycgenie.com/api/v2/verification/sessions/770e8400-e29b-41d4-a716-446655440002/resend/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"email": "john.doe.work@example.com"}'

import requests, uuid

response = requests.post(
    "https://api.kycgenie.com/api/v1/verification/sessions/770e8400-e29b-41d4-a716-446655440002/resend/",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={"email": "john.doe.work@example.com"},
)
print(response.json())

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

client.identity_verification.resend(
    session_id="770e8400-e29b-41d4-a716-446655440002",
    email="john.doe.work@example.com",  # omit to resend to original address
)

const response = await fetch(
  "https://api.kycgenie.com/api/v1/verification/sessions/770e8400-e29b-41d4-a716-446655440002/resend/",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
      "Idempotency-Key": crypto.randomUUID(),
    },
    body: JSON.stringify({ email: "john.doe.work@example.com" }),
  }
);
const data = await response.json();

const response = await fetch(
  "https://api.kycgenie.com/api/v2/verification/sessions/770e8400-e29b-41d4-a716-446655440002/resend/",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
      "Idempotency-Key": crypto.randomUUID(),
    },
    body: JSON.stringify({ email: "john.doe.work@example.com" }),
  }
);
const data = await response.json();

curl -X DELETE https://api.kycgenie.com/api/v1/verification/sessions/770e8400-e29b-41d4-a716-446655440002/revoke/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

curl -X DELETE https://api.kycgenie.com/api/v2/verification/sessions/770e8400-e29b-41d4-a716-446655440002/revoke/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

import requests, uuid

response = requests.delete(
    "https://api.kycgenie.com/api/v1/verification/sessions/770e8400-e29b-41d4-a716-446655440002/revoke/",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Idempotency-Key": str(uuid.uuid4()),
    },
)
print(response.json())

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

client.identity_verification.revoke_session(
    session_id="770e8400-e29b-41d4-a716-446655440002",
)

const response = await fetch(
  "https://api.kycgenie.com/api/v1/verification/sessions/770e8400-e29b-41d4-a716-446655440002/revoke/",
  {
    method: "DELETE",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Idempotency-Key": crypto.randomUUID(),
    },
  }
);
const data = await response.json();

const response = await fetch(
  "https://api.kycgenie.com/api/v2/verification/sessions/770e8400-e29b-41d4-a716-446655440002/revoke/",
  {
    method: "DELETE",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Idempotency-Key": crypto.randomUUID(),
    },
  }
);
const data = await response.json();

curl "https://api.kycgenie.com/api/v1/entities/550e8400-e29b-41d4-a716-446655440000/verification-sessions/?status=completed&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl "https://api.kycgenie.com/api/v2/entities/550e8400-e29b-41d4-a716-446655440000/verification-sessions/?status=completed&page_size=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.kycgenie.com/api/v1/entities/550e8400-e29b-41d4-a716-446655440000/verification-sessions/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"status": "completed", "limit": 20},
)
data = response.json()
print(f"Total: {data['count']}")
for session in data['results']:
    print(session['session_id'], session['status'], session['outcome'])

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

result = client.identity_verification.list_entity_sessions(
    entity_id="550e8400-e29b-41d4-a716-446655440000",
)

for session in result.results:
    print(session.session_id, session.status, session.outcome)

const params = new URLSearchParams({ status: "completed", limit: 20 });
const response = await fetch(
  `https://api.kycgenie.com/api/v1/entities/550e8400-e29b-41d4-a716-446655440000/verification-sessions/?${params}`,
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);
const data = await response.json();
console.log(`Total: ${data.count}`);
data.results.forEach(s => console.log(s.session_id, s.status));

const params = new URLSearchParams({ status: "completed", page_size: 20 });
const response = await fetch(
  `https://api.kycgenie.com/api/v2/entities/550e8400-e29b-41d4-a716-446655440000/verification-sessions/?${params}`,
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);
const data = await response.json();
data.results.forEach(s => console.log(s.session_id, s.status));
if (data.has_more) console.log("Next cursor:", data.next_cursor);

curl "https://api.kycgenie.com/api/v1/verification/sessions/list/?status=pending&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl "https://api.kycgenie.com/api/v2/verification/sessions/list/?status=pending&page_size=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.kycgenie.com/api/v1/verification/sessions/list/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"status": "pending", "limit": 50},
)
data = response.json()
print(f"Total: {data['count']}")
for session in data['results']:
    print(session['session_id'], session['status'])

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

result = client.identity_verification.list_sessions(
    status="pending",
    page_size=50,
)

for session in result.results:
    print(session.session_id, session.status)

# Paginate through all results
while result.has_more:
    result = client.identity_verification.list_sessions(
        status="pending",
        after=result.next_cursor,
        page_size=50,
    )
    for session in result.results:
        print(session.session_id, session.status)

const params = new URLSearchParams({ status: "pending", limit: 50 });
const response = await fetch(
  `https://api.kycgenie.com/api/v1/verification/sessions/list/?${params}`,
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);
const data = await response.json();
console.log(`Total: ${data.count}`);

const params = new URLSearchParams({ status: "pending", page_size: 50 });
const response = await fetch(
  `https://api.kycgenie.com/api/v2/verification/sessions/list/?${params}`,
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);
const data = await response.json();
data.results.forEach(s => console.log(s.session_id, s.status));
if (data.has_more) console.log("Next cursor:", data.next_cursor);

curl -X POST https://api.kycgenie.com/api/v1/verification/sessions/770e8400-e29b-41d4-a716-446655440002/reviews/create/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "decision": "approved",
    "notes": "Identity verified successfully. All checks clear."
  }'

curl -X POST https://api.kycgenie.com/api/v2/verification/sessions/770e8400-e29b-41d4-a716-446655440002/reviews/create/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "decision": "approved",
    "notes": "Identity verified successfully. All checks clear."
  }'

import requests, uuid

response = requests.post(
    "https://api.kycgenie.com/api/v1/verification/sessions/770e8400-e29b-41d4-a716-446655440002/reviews/create/",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "decision": "approved",
        "notes": "Identity verified successfully. All checks clear.",
    },
)
print(response.json())

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

review = client.identity_verification.create_review(
    session_id="770e8400-e29b-41d4-a716-446655440002",
    decision="approved",
    notes="Identity verified successfully. All checks clear.",
)

print(review.review_id)
print(review.decision)    # "approved"

const response = await fetch(
  "https://api.kycgenie.com/api/v1/verification/sessions/770e8400-e29b-41d4-a716-446655440002/reviews/create/",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
      "Idempotency-Key": crypto.randomUUID(),
    },
    body: JSON.stringify({
      decision: "approved",
      notes: "Identity verified successfully. All checks clear.",
    }),
  }
);
const review = await response.json();

const response = await fetch(
  "https://api.kycgenie.com/api/v2/verification/sessions/770e8400-e29b-41d4-a716-446655440002/reviews/create/",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
      "Idempotency-Key": crypto.randomUUID(),
    },
    body: JSON.stringify({
      decision: "approved",
      notes: "Identity verified successfully. All checks clear.",
    }),
  }
);
const review = await response.json();

curl https://api.kycgenie.com/api/v1/verification/sessions/770e8400-e29b-41d4-a716-446655440002/reviews/ \
  -H "Authorization: Bearer YOUR_API_KEY"

curl https://api.kycgenie.com/api/v2/verification/sessions/770e8400-e29b-41d4-a716-446655440002/reviews/ \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.kycgenie.com/api/v1/verification/sessions/770e8400-e29b-41d4-a716-446655440002/reviews/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
data = response.json()
for review in data['reviews']:
    print(review['decision'], review['reviewed_at'])

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

reviews = client.identity_verification.list_session_reviews(
    session_id="770e8400-e29b-41d4-a716-446655440002",
)

print(f"Latest decision: {reviews.latest_decision}")
for review in reviews.results:
    print(review.decision, review.reviewed_at)

const response = await fetch(
  "https://api.kycgenie.com/api/v1/verification/sessions/770e8400-e29b-41d4-a716-446655440002/reviews/",
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);
const data = await response.json();
data.reviews.forEach(r => console.log(r.decision, r.reviewed_at));

const response = await fetch(
  "https://api.kycgenie.com/api/v2/verification/sessions/770e8400-e29b-41d4-a716-446655440002/reviews/",
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);
const data = await response.json();
// v2: results[] instead of reviews[], count instead of total_reviews
data.results.forEach(r => console.log(r.decision, r.reviewed_at));
console.log("Latest:", data.latest_decision);