api.luka.zone luka.zone →
Greylist-Belarus · v1

A KYC lookup for the Belarus repressions database.

Programmatic access to the para2022 / luka.zone register of persons involved in political repressions in Belarus and crimes against humanity in Ukraine. Built for KYC partners, financial institutions, and online platforms.

We do not auto-block users. We return a confidence-scored match with the evidence behind it, so your compliance team makes the final call.

See the quickstart

01How it works

Three steps from first email to live integration.

  1. 1

    Request access

    Email contact@luka.zone with your company name, intended use case, and expected query volume. We review each request manually and respond within a few business days.

  2. 2

    Receive your key

    If approved, we issue an API key and send it to you by email. Store it in your secrets manager — the raw key is shown only once on our side.

  3. 3

    Call /v1/match

    Send whatever identifiers you collect at KYC time — personal ID number, name, date of birth, phone, email, Telegram ID, address. Our matching engine returns a scored decision in a single round-trip.

02Quickstart

Base URL:https://api.luka.zone Auth:Authorization: Api-Key <key>

Request

POST /v1/match
curl -X POST https://api.luka.zone/v1/match \
  -H "Authorization: Api-Key <prefix>.<secret>" \
  -H "Content-Type: application/json" \
  -d '{
    "last_name": "Лукашенко",
    "first_name": "Александр",
    "date_of_birth": "1954-08-30",
    "partner_reference": "tx_abc123"
  }'

Response

200 OK · application/json
{
  "request_id": "a3f1c4...",
  "partner_reference": "tx_abc123",
  "decision": "review",
  "matches": [
    {
      "person_id": "550e8400-...",
      "score": 0.72,
      "matched_fields": [
        { "field": "last_name", "method": "phonetic", "similarity": 0.95 },
        { "field": "date_of_birth", "method": "exact", "similarity": 1.0 }
      ],
      "summary": {
        "full_name": "Лукашенко Александр Григорьевич",
        "category": "executive",
        "region": "MINSK_CITY",
        "sources_count": 47,
        "profile_url": "https://luka.zone/person/550e8400-..."
      }
    }
  ],
  "checked_at": "2026-04-24T10:15:00Z"
}
Use it as a signal, never as an auto-block. The decision field is one of clear, review, or likely_match. Your compliance team should review every review and likely_match result.

03Endpoints

MethodPathPurpose
POST /v1/match Lookup a person against the database. Flexible input — any combination of identifiers. Returns up to 5 scored matches.
GET /v1/match/{person_id} Full evidence bundle for a flagged match: crime description, sources, translations, profile URL, photo URL.
GET /v1/health Liveness probe + database freshness timestamp. No auth required.

04Intended partners

Anyone with KYC or AML obligations who would rather not onboard a sanctioned official by accident.

05Rate limits & terms

Every key has a per-minute rate limit set at issue time (basic tier: 60 req/min). Higher volumes available on request. Every query is logged for abuse detection and audit. Input data you send is encrypted at rest and retained only for operational purposes — we are a lookup service, not a data store.

Results are informational. We make no warranty that a person not returned is clear, nor that a returned match is conclusive. Final decisions remain the partner's responsibility.

Ready to integrate?

Email us and we'll get you onboarded within a few business days.

contact@luka.zone