VKN ile Sorgulama

Genel Bilgi — POST /v1/search/vkn

Maliyet: Bakiye panelinizden görüntüleyebilirsiniz | Girdi: Vergi Kimlik Numarası (10 hane)

İstek

{ "vkn": "9000500394" }

Yanıt

{
  "success": true,
  "dusulen_bakiye": 1,
  "response_time_ms": 312,
  "data": {
    "Merkez": {
      "MersisNo": "0900050039462851",
      "Unvani": "UYUMSOFT KURUMSAL İŞ SİSTEMLERİ VE TEKNOLOJİLERİ ANONİM ŞİRKETİ",
      "IsletmeAdi": "",
      "FirmaNeviGrupId": "3",
      "FirmaNeviGrup": "ANONİM ŞİRKET",
      "FirmaNeviId": "23",
      "FirmaNevi": "TEK PAY SAHİPLİ ANONİM ŞİRKET",
      "TSMNo": "258",
      "TSM": "İSTANBUL TİCARET SİCİLİ MÜDÜRLÜĞÜ",
      "SicilNo": "861837-0",
      "VergiDairesiKodu": "034235",
      "VergiDairesi": "ESENLER VERGİ DAİRESİ",
      "TescilTarihi": "01.04.2013",
      "IseBaslamaTarihi": "01.04.2013",
      "KapanisTarihi": "",
      "FirmaDurumTipNo": "1",
      "Durumu": "Aktif",
      "Adres": "ÇİFTE HAVUZLAR MAH. ESKİ LONDRA ASFALTI CAD. ... ESENLER / İSTANBUL",
      "AmacKonuIcerik": [
        { "AmacKonuIcerik": "..." }
      ],
      "SirketinToplamSermayesi": 1000000,
      "InternetSitesi": []
    }
  }
}

Tüm şirket bilgisi data.Merkez altında gelir.

Alan Açıklamaları (data.Merkez)

Alan	Tip	Açıklama
MersisNo	String	16 haneli MERSIS numarası
Unvani	String	Ticaret ünvanı
IsletmeAdi	String	İşletme / tabela adı
FirmaNeviGrup	String	Şirket türü (ANONİM ŞİRKET, LİMİTED ŞİRKET…)
FirmaNevi	String	Şirket alt türü
TSM	String	Kayıtlı Ticaret Sicili Müdürlüğü
SicilNo	String	Ticaret sicil numarası
VergiDairesi	String	Bağlı vergi dairesi
TescilTarihi	String	Tescil tarihi (GG.AA.YYYY)
IseBaslamaTarihi	String	İşe başlama tarihi
KapanisTarihi	String	Kapanış tarihi (aktif şirkette boş "")
Durumu	String	Aktif, Tasfiye, Terkin vb.
Adres	String	Ticari adres
AmacKonuIcerik	Array	Şirket amaç ve konu metni
SirketinToplamSermayesi	Number	Toplam sermaye (TL)
InternetSitesi	Array	Web sitesi adresleri

Erişim Örneği

const result = await searchByVkn('9000500394')
const merkez = result.data.Merkez

console.log(merkez.Unvani)    // "UYUMSOFT KURUMSAL İŞ SİSTEMLERİ..."
console.log(merkez.Durumu)    // "Aktif"
console.log(merkez.Adres)     // "ÇİFTE HAVUZLAR MAH..."
console.log(merkez.MersisNo)  // "0900050039462851"

---

Detaylı Bilgi — POST /v1/search/vkn/detail

Maliyet: Bakiye panelinizden görüntüleyebilirsiniz | Girdi: Vergi Kimlik Numarası (10 hane)

data.Merkez içindeki tüm alanlara ek olarak şu bölümler de döner:

İstek

{ "vkn": "9000500394" }

Yanıt Yapısı

{
  "success": true,
  "dusulen_bakiye": 3,
  "data": {
    "Merkez": { "...genel_bilgi_alanlari..." },
    "AdresDetay": {
      "IlAdi": "İSTANBUL",
      "IlceAdi": "ESENLER",
      "Mahalle": "ÇİFTE HAVUZLAR MAHALLESİ",
      "CSBM": "ESKİ LONDRA ASFALTI CADDESİ",
      "DisKapiNo": "151",
      "IcKapiNo": "1C/113",
      "PostaKodu": 34220
    },
    "Naceler": [
      {
        "NACEKodu": "62.01",
        "Tanimi": "Bilgisayar programlama faaliyetleri",
        "AnaFaliyetMi": "True"
      }
    ],
    "SermayeDetay": {
      "SirketinToplamSermayesi": 1000000,
      "NamaYaziliHisseAdedi": 100000,
      "HamilineYaziliHisseAdedi": 0,
      "BirPayDegeri": 10
    },
    "Ortaklar": [
      {
        "Adi": "MEHMET",
        "Soyadi": "******",
        "OrtaklikTipi": "Gerçek Kişi",
        "TCKimlikNoMersisNo": "",
        "OrtaginToplamSermayedekiYuzdesi": 100.0,
        "BaslangicTarihi": "01.04.2013"
      }
    ],
    "AktifTemsilciler": [
      {
        "Adi": "AHMET",
        "Soyadi": "******",
        "Gorevi": "YÖNETİM KURULU ÜYESİ",
        "TemsilTuru": "MÜNFERİT",
        "SinirsizMi": 1,
        "BaslangicTarihi": "01.01.2020"
      }
    ],
    "AktifUyeler": [],
    "Denetciler": [],
    "IflasKonkordato": [],
    "Subeler": [
      {
        "MersisNo": "0900050039400002",
        "Unvani": "UYUMSOFT - İSTANBUL ŞUBESİ",
        "TSM": "İSTANBUL TİCARET SİCİLİ MÜDÜRLÜĞÜ",
        "SicilNo": "123456",
        "TescilTarihi": "20.05.2010",
        "Adres": "Levent/İSTANBUL"
      }
    ]
  }
}

Gerçek kişilerin soyisimleri maskelenir: ortak, yönetici, temsilci ve denetçilerin Soyadi alanı ****** şeklinde döner. Ad açık gelir.

TC Kimlik No ve Pasaport No gönderilmez: gerçek kişilere ait TCKimlikNoMersisNo, VergiNumarasi ve PasaportNo alanları boş ("") döner.

Subeler listesindeki MersisNo değerini kullanarak şube detayı için /v1/search/mersis çağırabilirsiniz. → Şube Kartı

Erişim Örneği

const result = await searchByVknDetail('9000500394')
const { Merkez, Ortaklar, AktifTemsilciler, Subeler } = result.data

console.log(Merkez.Unvani)
console.log(Ortaklar[0].OrtaginToplamSermayedekiYuzdesi)
console.log(AktifTemsilciler[0].Gorevi)

// Şube varsa şube kartını al
if (Subeler.length > 0) {
  const subeDetay = await searchByMersis(Subeler[0].MersisNo)
}