Şirket Doğrulama API’si · eKYB

Türk şirketlerini resmî sicilden anında doğrulayın.

Apivom Atlas, sistemlerinize yalnızca bir vergi numarası ile MERSİS şirket verilerine gerçek zamanlı erişim sağlar. Müşteri kabulü, durum tespiti ve risk kontrolleri için tek API.

  • Resmî MERSİS kaynağı
  • GDPR ve KVKK uyumlu
  • REST · JSON · API anahtarı
  • TLS 1.3
  • Şirket adıyla arama
Atlas Portalı’nı açınEntegrasyon kılavuzunu okuyun
atlas · şirket kartı 03200 OK · ~200 ms
İstek
POST https://atlas.apivom.com/tobb/api/v1/query/company-card-partners-v2
Content-Type: application/json
x-api-key: <API anahtarınız>

{ "VergiNo": "1234567890" }
Yanıt
{
  "data": {
    "Merkez": [{
      "MersisNo": "0123456789012345",
      "Unvani": "ORNEK GIDA SANAYI VE TICARET A.S.",
      "FirmaNevi": "ANONIM SIRKET",
      "Durumu": "Aktif",
      "TescilTarihi": "15.03.2018",
      "SirketinToplamSermayesi": 1000000
    }],
    "Naceler": [{ "NACEKodu": "10.11.01", "AnaFaliyetMi": "True" }],
    "Ortaklar": [{
      "Adi": "AYSE", "Soyadi": "ORNEK",
      "TCKimlikNoMersisNo": "123******45",   // maskeli
      "PayAdedi": 60000
    }],
    "AktifTemsilciler": [ … ], "AktifUyeler": [ … ], "Denetciler": [ … ]
  },
  "charged": true, "chargeMinor": "125", "cached": false
}

* Yanıt süresi Atlas API’sinde ölçülür; sicilin kendi gecikmesi hariçtir. Bu sayfadaki örnek veriler kurgusaldır.

ortalama API yanıt süresi*
200 ms
erişilebilirlik hedefi
%99,9
API erişimi
7/24
seçilebilir veri modeli
5

Neden eKYB

Belge kovalamacasından tek API çağrısına.

Her B2B ilişki aynı soruyla başlar: bu şirket gerçekten iddia ettiği şirket mi? KYC bunu kişiler için, KYB ise şirketler için yanıtlar. eKYB yanıtı resmî sicilden, bir API üzerinden alır.

Geleneksel KYB

  • Ticaret Sicili Gazetesi sureti
  • İmza sirküleri
  • Vergi levhası
  • Kaşeli faaliyet belgesi

Biri yükler, bir başkası okur; ikisi de PDF basıldığından beri hiçbir şeyin değişmediğini umar.

Atlas ile eKYB

  • Müşteri vergi numarasını girer
  • Arka uç sisteminiz resmî sicili sorgular
  • Yapılandırılmış JSON milisaniyeler içinde gelir
  • Her sonuçta kaynak ve zaman damgası

Yapılandırılmış veri yeniden kontrol edilebilir, karşılaştırılabilir ve denetlenebilir. Kâğıt bunu asla yapamaz.

KYC: kişi
Gerçek kişilerde kimlik, adres ve yaptırım kontrolleri.
KYB: şirket
Bir tüzel kişinin varlığı, durumu, kimliği, faaliyeti, ortaklık yapısı, kontrolü ve risk sinyalleri.
Kesiştikleri nokta
Kart 03 ortakları, yönetim kurulu üyelerini ve imza yetkililerini sayar; KYC ve tarama kontrolleriniz bu kişileri kapsar.

Sahayı tanıyın

Bir Türk şirketini doğrulamak neden göründüğünden zor?

İki kimlik numarası
Şirketlerin 10 haneli vergi kimlik numarası (VKN) ve 16 haneli MERSİS numarası vardır. Müşteriler ilkini bilir, sicil ise ikincisini kullanır. Atlas vergi numarasını kabul eder. VergiNo → MersisNo
Şahıs işletmeleri kişidir
Bir kişi aynı numarayla birden fazla işletme yürütebilir; bu nedenle bir sorgu birden fazla kayıt döndürebilir. Atlas hepsini döndürür — Merkez[ ] bir dizidir.
Şubeler ayrı kayıtlardır
Her şubenin kendi MERSİS numarası vardır. Merkezi doğrulamak, siparişi imzalayan şube hakkında hiçbir şey söylemez. Şube Kartı’nı kullanın.
Hukuki gerçek Gazete’dedir
Değişiklikler Ticaret Sicili Gazetesi’nde ilan edildiğinde bağlayıcı olur. Kart 04 en son ilanı orijinal PDF olarak döndürür (SonGazete).

Örnek akış

Örnek bir eKYB akışı

  1. 1

    Alın

    Vergi numarasını toplayın veya şirket adıyla bulun.

  2. 2

    Kontrol edin

    Arka uçtan Kart 01’i çalıştırın: şirket var mı ve faal mi?

  3. 3

    Derinleştirin

    Risk eşiğinizin üzerinde Kart 03’ü, sözleşme imzasından önce Kart 04’ü çalıştırın.

  4. 4

    Kanıtı saklayın

    Yanıtı ve zaman damgasını müşteri kaydıyla birlikte saklayın.

  5. 5

    Yeniden doğrulayın

    Yenilemede, ödemede veya bir risk tetikleyicisinde tekrar çalıştırın. Tekrarlanan sorgular önbellekten ücretsiz sunulur.

Veri akışı

Resmî sicilden sistemlerinize tek çağrıyla.

Atlas, MERSİS ile sistemleriniz arasında yer alır: kimlik doğrular, maskeler, kayıt tutar ve temiz, yapılandırılmış JSON döndürür.

MERSİS

Merkezi Sicil Kayıt Sistemi: resmî makamların kullandığı kayıtların aynısı.

  • Ticaret sicili kayıtları
  • Ticaret Sicili Gazetesi
  • İflas ve konkordato

Apivom Atlas API

Tek temel URL. Kartı rota seçer.

  • Kiracı başına API anahtarı · TLS 1.3
  • Kişisel kimlik numaralarında KVKK maskelemesi
  • Her sonuçta kaynak ve zaman damgası
  • Sorgu hızı sınırı · tam denetim kaydı
  • Ön ödemeli bakiye · sorgu başına ücret

Sistemleriniz

Yanıtı doğrudan kullandığınız araçlara aktarın.

  • CRM ve ERP
  • KYB / müşteri kabul akışları
  • Risk ve kredi motorları

Veri modelleri

Tek vergi numarası. Beş derinlikte veri.

Her Şirket Kartı bir öncekinin üzerine kurulur; yalnızca sürecinizin gerektirdiği ayrıntı için ödeme yaparsınız.

Kart 01

Temel

company-card-basic-v2

girdi: VergiNo (vergi no.)

0,40 $ / sorgu

Merkez21 temel alan: unvan, tür, sicil ve vergi dairesi, durum, tarihler, adres, amaç ve konu, sermaye, internet siteleri

derinlik 1 / 4

Kart 02

Ayrıntılı

company-card-address-nace-v2

girdi: VergiNo (vergi no.)

0,65 $ / sorgu

Merkez

+ ekler

AdresDetayyapılandırılmış adres
NacelerNACE faaliyet kodları
SermayeDetaypay adedi ve pay değeri

derinlik 2 / 4

Kart 03

Kişiler

company-card-partners-v2

girdi: VergiNo (vergi no.)

1,25 $ / sorgu

Kart 02 grupları

+ ekler

Ortaklarortaklar ve paylar
AktifTemsilcilertemsilciler ve yetkileri
AktifUyeleryönetim kurulu ve görev süreleri
Denetcilerbağımsız denetçiler

derinlik 3 / 4

Kart 04

Tam

company-card-full-v2

girdi: VergiNo (vergi no.)

1,55 $ / sorgu

Kart 03 grupları

+ ekler

IflasKonkordatoiflas ve konkordato
Subeleraktif şubeler (en fazla 50)
SonGazeteson Gazete ilanı · PDF

derinlik 4 / 4

Şube Kartı

Şube

branch-card

girdi: şube MersisNo

0,65 $ / sorgu

Subetemel şube kaydı
AktifTemsilcilerşube temsilcileri
Gazete PDF’işubenin son ilanı
Kapsanan verilerKart 01Kart 02Kart 03Kart 04Şube Kartı
Temel şirket verileri: unvan, sicil ve vergi dairesi, durum, adres, sermaye—
Ayrıntılı adres, NACE faaliyet kodları, sermaye ayrıntısı——
Ortaklar, yönetim kurulu üyeleri, temsilciler, bağımsız denetçiler———
İflas ve konkordato, aktif şubeler, son Gazete PDF’i————
Tek şube bilgileri, temsilcileri ve Gazete PDF’i————

Şirket Kartları vergi numarasıyla, Şube Kartı ise şubenin MERSİS numarasıyla sorgulanır.

Şirket arama · yalnızca Atlas’ta

Elinizde yalnızca bir isim mi var? Şirketi bulun.

Müşteriler vergi numaralarını nadiren ezbere bilir. Atlas Şirket Arama, Türk şirketlerini adıyla bulur ve vergi numaralarını her Şirket Kartı için hazır şekilde döndürür.

Ticaret unvanının tamamını veya bir kısmını yazın — örnek gıda — ve eşleşen şirketleri vergi numaralarıyla birlikte alın: ÖRNEK GIDA SANAYİ VE TİCARET A.Ş. (VKN 1234567890), ÖRNEK GIDA PAZARLAMA LTD. ŞTİ. (VKN 2345678901), … Doğru şirketi seçin ve bir sonraki çağrıda Kart 01, 02, 03 veya 04’ü çalıştırın.

Arama, GİB e-Fatura sistemine kayıtlı şirketleri kapsar. Çok yeni kurulan şirketler henüz görünmeyebilir; bu şirketler her zaman doğrudan vergi numarasıyla sorgulanabilir.

Adıyla arayın
Ticaret unvanının tamamını veya bir kısmını yazın, eşleşen şirketleri vergi numaralarıyla birlikte alın.
Doğrudan kartlara
Doğru şirketi seçin ve bir sonraki çağrıda Kart 01, 02, 03 veya 04’ü çalıştırın.
Resmî vergi verisine dayanır
Gelir İdaresi Başkanlığı’nın (GİB) e-Fatura mükellef kayıtlarına dayanır.
Portal’da görün
2 milyon+
Türk şirketi adıyla aranabilir
0,10 $
arama başına

Fiyatlandırma

Sorgu başına ödeyin. Platform ücreti yok.

Fiyatlar sorgu başınadır ve KDV hariçtir. Her kartın tek bir fiyatı vardır: bir Kart 04 sorgusu, Kart 01–04 fiyatlarının toplamı olarak ücretlendirilmez. Aynı parametrelerle tekrarlanan sorgular önbellekten ücretsiz sunulur.

Kart 01

Temel

company-card-basic-v2

$0,40

sorgu başına

Kart 02

Ayrıntılı

company-card-address-nace-v2

$0,65

sorgu başına

Kart 03

Kişiler

company-card-partners-v2

$1,25

sorgu başına

Kart 04

Tam

company-card-full-v2

$1,55

sorgu başına

Şube Kartı

Şube

branch-card

$0,65

sorgu başına

Ayrıcalıklı ek hizmet

Şirket adıyla arama

Şirketleri adıyla bulun, vergi numaralarını her kart için hazır şekilde alın.

$0,10

arama başına

$1.700
İlk ön ödeme

Hesabınızı açar. Tutarın tamamı sorgu bakiyenizdir; hiçbir kısmı ücret değildir.

$550
Asgari yükleme

İhtiyaç duyduğunuzda banka havalesiyle yükleyin. Bakiyeniz azaldığında uyarı alırsınız.

24 ay
Bakiye geçerliliği

Son yüklemenizden itibaren sayılır. Her yükleme tüm bakiyenin süresini uzatır.

$0
Kayıt yoksa ücret yok

Sicilde kaydı bulunamayan sorgular ücretsizdir. Önbellekten dönen yanıtlar da ücretsizdir.

Fiyatlara KDV dahil değildir ve her ocak ayında resmî sicil tarifesine göre güncellenir. Taahhüt karşılığında hacim indirimi sunulabilir. Ön ödemeler ve faturalar USD cinsindendir.

Neler alabilirsiniz

Tek sorguyla on iki yanıt.

Aşağıdakilerin tümü, seçtiğiniz karta göre tek bir vergi numarası sorgusuyla döner.

Şirket unvanı
Ticaret unvanı ve şirket türünün resmî sicil kaydı. Merkez.Unvani · Kart 01+
Tescil tarihleri
Tescil, işe başlama ve kapanış. Merkez.TescilTarihi · Kart 01+
Kayıtlı adres
Tam adres ve bina düzeyine kadar yapılandırılmış ayrıntı. AdresDetay[] · Kart 02+
NACE faaliyet kodları
Ana faaliyeti işaretlenmiş ekonomik sınıflandırma. Naceler[] · Kart 02+
Sermaye bilgileri
Toplam sermaye, nama ve hamiline yazılı paylar, pay değeri. SermayeDetay · Kart 02+
Ortaklar
Ortaklık yapısı ve paylar. Ortaklar[] · Kart 03+
Temsilciler
Yetkili temsilciler ve temsil yetkilerinin kapsamı. AktifTemsilciler[] · Kart 03+
Yönetim kurulu üyeleri
Aktif yöneticiler ve görev süreleri. AktifUyeler[] · Kart 03+
Bağımsız denetçiler
Denetim şirketi, denetim dönemi ve ayrıntılar. Denetciler[] · Kart 03+
İflas ve konkordato
İflas ve konkordato süreçleri, mahkeme ve karar tarihleri. IflasKonkordato[] · Kart 04
Şubeler
Bağlı tüm şubeler, her biri kendi Şube Kartıyla. Subeler[] · Kart 04 · Şube
Ticaret Sicili Gazetesi
En son yayımlanan ilan, PDF olarak. SonGazete · Kart 04 · Şube

Nasıl çalışır

Üç adımda kullanıma başlayın.

Platform ücreti yok: bakiyenizi önceden yüklersiniz, her sorgu kullandıkça düşülür. Kayıt bulunamayan sorgular ücretsizdir.

  1. 1

    Kaydolun

    Atlas Portalı hesabınızı oluşturun ve bir API anahtarı üretin; anahtarı istediğiniz zaman yenileyebilirsiniz.

  2. 2

    Bakiye yükleyin

    Banka havalesiyle ön ödemeli bakiye yükleyin. Her sorgu yapıldığı anda düşülür; GET /tobb/api/v1/balance bakiyenizi gösterir.

  3. 3

    Sorgulayın

    İhtiyacınız olan kart rotasına bir vergi numarası POST edin, milisaniyeler içinde yapılandırılmış JSON alın.

Neden Atlas

Tahmine değil, kanıta ihtiyaç duyan ekipler için.

Resmî kaynak
Veriler doğrudan Merkezi Sicil Kayıt Sistemi MERSİS’ten gelir; resmî makamların kullandığı kayıtların aynısıyla çalışırsınız.
Uyum için tasarlandı
GDPR ve KVKK uyumlu. Kişisel tanımlayıcılar maskelenir ve her erişim ayrıntılı denetim kaydına işlenir.
Kolay entegrasyon
Makine tarafından okunabilir kılavuzu ve API anahtarıyla kimlik doğrulaması olan RESTful JSON API. CRM, ERP veya müşteri kabul akışınıza bağlayın.

Kimler için

Bir Türk şirketinin kontrol edilmesi gereken her yerde.

Müşteri kabulü
Şirket bilgilerini otomatik doğrulayın.
Durum tespiti ve uyum
Mevzuat ve KYB kontrollerini destekleyin.
B2B iş ortaklıkları
Potansiyel iş ortaklarını hızla analiz edin.
Risk yönetimi
Bir şirketin hukuki durumunu ve iflas ilanlarını kontrol edin.
CRM ve ERP zenginleştirme
Müşteri verilerini eksiksiz ve güncel tutun.
Finans ve e-ticaret
Kredi değerlendirmesi ve kurumsal müşteri kabulü.

Tasarımdan güvenli

Her adımda güvenlik ve gizlilik.

API anahtarıyla kimlik doğrulama
Atlas Portalı’nda verilen, istediğiniz zaman yenileyebileceğiniz kiracıya özel anahtarlar.
TLS 1.3
Aktarımda uçtan uca şifreleme.
Sorgu hızı sınırı
API isteklerinin kontrollü yönetimi.
Tam denetim kaydı
Her erişim, istek ve yanıt içerikleriyle birlikte Portal’da ayrıntılı olarak kaydedilir.
GDPR ve KVKK
Uyumlu işleme ve maskeleme kuralları.
Yalnızca arka uçtan
Atlas’ı sunucularınızdan çağırın; API anahtarları asla URL’lerde veya istemci tarafı kodda yer almamalıdır.

Bilmeniz gerekenler

Veriler ve sınırları konusunda şeffafız.

Atlas’ın ne döndürdüğü, verilerin nereden geldiği ve Atlas’ın ne olmadığı.

Resmî kaynak
Veriler, T.C. Ticaret Bakanlığı’nın Merkezi Sicil Kayıt Sistemi MERSİS’ten TOBB aracılığıyla alınır. Her sonuç kaynağını ve alındığı zamanı gösterir.
Sorgu anındaki sicil kaydı
Sonuçlar, sicilin sorgu anındaki durumunu yansıtır. Apivom verileri oluşturmaz veya düzeltmez; verilerin doğruluğu kaynak kurumların sorumluluğundadır.
Resmî belge değildir
Sonuçlar resmî belge, sicil özeti veya kredi derecelendirmesi değildir. Kendi değerlendirmenizi destekler, onun yerine geçmez.
Sınırlamaları bilin
Anonim şirketlerde (A.Ş.) pay devirleri sicile tescil edilmez (TTK md. 499); bu nedenle ortak bilgileri boş veya güncel olmayabilir. Sınırlamaların tam listesi dokümantasyonda yer alır.

Atlas’ı denemeye hazır mısınız?

Portal’ı açın, TOBB sağlayıcısını etkinleştirin ve ilk şirket kartınızı çalıştırın — ya da ihtiyacınız olan kartları bize bildirin, hesabınızı kuralım.

Atlas Portalı’nı açınDemo talep edin

Bilgiler resmî kamu kayıtlarından (MERSİS) elde edilmektedir. Bilgilerin doğruluğu kaynak kurumların sorumluluğundadır. Verilere dayanılarak tesis edilen işlemlerden T.C. Ticaret Bakanlığı ve TOBB sorumlu değildir. Apivom bağımsız bir hizmet sağlayıcıdır; Ticaret Bakanlığı veya TOBB ile bağlantılı değildir ve onlar tarafından onaylanmamıştır. Hizmetin kullanımı Atlas Kullanım Koşullarına tabidir.