Queries with TIN

It is used to inquire whether a company/person is an e-Invoice taxpayer or not using TIN/TC ID number.

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

get

/general/GlobalCompany/Check/TaxNumber/{TaxNumber}

Authorizations

Path parameters

TaxNumberstringrequired

Query parameters

globalUserTypestring · enum

Options: Invoice, DespatchAdvice

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/general/GlobalCompany/Check/TaxNumber/{TaxNumber}' \
  --header 'Authorization: Bearer JWT'

200

400

403

404

200

[
  {
    "TaxNumber": "text",
    "Title": "text",
    "FirstCreatedTime": "2025-02-28T07:43:45.381Z",
    "CreationTime": "2025-02-28T07:43:45.381Z",
    "DocumentType": "text",
    "Name": "text",
    "Type": "text"
  }
]

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

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);
});