VKN ile Sorgular

Bir firma/kişinin e-Fatura mükellefi olup olmadığını VKN/TCKN ile sorgulamak için kullanılır.

Vergi numarasından mükellef olup olmadığı sorgular.

get

Authorizations

Path parameters

TaxNumberstringRequired

Query parameters

globalUserTypestring · enumOptionalPossible values:

Responses

200

Vergi numarasından mükellef olup olmadığı sorgular.

application/json

400

Geçersiz İstek | Gönderdiğiniz istekte geçersiz veriler bulunduğu anlamında gelmektedir | Detaylar için tıklayınız

403

Yetkisiz Erişim | Bu uca erişmek için gerekli yetkiye sahip olmadığınız durumda dönülür

404

Parametrede belirtilen kayıt bulunamadığında dönülür | Detaylar için tıklayınız

get

HTTPcURLJavaScriptPython

GET /general/GlobalCompany/Check/TaxNumber/{TaxNumber} HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*

[
  {
    "TaxNumber": "text",
    "Title": "text",
    "FirstCreatedTime": "2025-06-24T16:43:38.791Z",
    "CreationTime": "2025-06-24T16:43:38.791Z",
    "DocumentType": "text",
    "Name": "text",
    "Type": "text"
  }
]

C#

var client = new RestClient("https://apitest.nilvera.com/general/GlobalCompany/Check/TaxNumber/34918613960?globalUserType=Invoice");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <API KEY>");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

PHP - cURL

<?php
$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://apitest.nilvera.com/general/GlobalCompany/Check/TaxNumber/34918613960?globalUserType=Invoice',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer <API KEY>'
  ),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;

NodeJs - Axios

var axios = require('axios');
var config = {
  method: 'get',
  url: 'https://apitest.nilvera.com/general/GlobalCompany/Check/TaxNumber/34918613960?globalUserType=Invoice',
  headers: { 
    'Authorization': 'Bearer <API KEY>'
  }
};
axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});