# 7. Vergi Numarası ile Sorgula

## **Cüzdan Kaydını Vergi Numarasıyla Tanımla** 

<mark style="color:green;">`GET`</mark> `{{WalletUrl}}/api/v1/walletowner/by/taxnumber/5049155355`

{% hint style="info" %}
**Not**: Bu servisi çağırmadan önce, **apikeypublic** ve **apiclientpublic** parametrelerini **Header** kısmına eklemeniz gereklidir.

[<mark style="color:green;">**WalletAPI Adresi**</mark>](/ortam.md)
{% endhint %}

**Servise gönderilmesi gereken parametreler şu şekildedir:**

<table><thead><tr><th width="162">Parametre</th><th width="79">Tip</th><th width="107">Zorunlu</th><th width="403">Açıklama</th></tr></thead><tbody><tr><td>apikeypublic</td><td>string</td><td>Evet</td><td>API servislerine yapılan isteklerde kimlik doğrulaması için kullanılan genel anahtar bilgisidir.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Evet</td><td>API çağrısının hangi istemciden geldiğini belirtmek için kullanılan genel istemci anahtarıdır.</td></tr></tbody></table>

**Servise gönderilmesi gereken (QueryString) parametreler şu şekildedir:**

<table><thead><tr><th width="162">Parametre</th><th width="403">Açıklama</th></tr></thead><tbody><tr><td>TaxNumber</td><td>Aramak istediğiniz cüzdan sahibinin vergi numarası bilgisi</td></tr></tbody></table>

{% tabs %}
{% tab title="Servis Cevap - Json" %}
{% code lineNumbers="true" %}

```json
{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "0a949877-0ea0-48c3-9c92-41c9e33c461d",
        "MaskedFullname": "E**s S****n",
        "Email": "Irwin.Funk@yahoo.com",
        "PhoneNumber": "+905350533481",
        "MaskedTaxNumber": "84*******8",
        "MaskedIdentityNumber": null,
        "OwnerType": "Corporate",
        "CompanyName": "test",
        "Address": "address",
        "Country": "country",
        "City": "city",
        "DateOfBirth": "2030-10-15",
        "CreatedAt": "2025-08-20T09:59:58.070493Z",
        "UpdatedAt": "2025-08-20T10:01:07.734415Z"
    }
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

## Servis Cevap

<table><thead><tr><th width="192">Parametre</th><th width="147.89192708333331">Tip</th><th>Açıklama</th></tr></thead><tbody><tr><td>IsFailure</td><td>bool</td><td>Yapılan API çağrısının başarısız olup olmadığını belirten değerdir. (true/false)</td></tr><tr><td>IsSuccess</td><td>bool</td><td>Yapılan API çağrısının başarılı olup olmadığını belirten değerdir. (true/false)</td></tr><tr><td>Errors</td><td>Array</td><td>Servis çağrısı sırasında oluşan hata mesajlarını ve detaylarını içeren alandır.</td></tr><tr><td>Value</td><td>Array&#x3C;Items></td><td>Başarılı API çağrısında dönen asıl veri kümesini temsil eder.</td></tr></tbody></table>

## Servis Cevap (Value)

<table><thead><tr><th>Parametre</th><th>Tip</th><th width="348.94140625">Açıklama</th></tr></thead><tbody><tr><td>Id</td><td>Guid</td><td>Sistemde tanımlı varlığın benzersiz kimlik numarasıdır.</td></tr><tr><td>MaskedFullname</td><td>string</td><td>Kullanıcının tam adının gizlenmiş (maskelenmiş) haliyle gösterildiği bilgidir.</td></tr><tr><td>Email</td><td>string</td><td>Kullanıcının kayıtlı e-posta adresi bilgisidir.</td></tr><tr><td>PhoneNumber</td><td>string</td><td>Kullanıcının kayıtlı telefon numarası bilgisidir.</td></tr><tr><td>MaskedTaxNumber</td><td>string</td><td>Kullanıcının vergi numarasının gizlenmiş (maskelenmiş) şekilde gösterildiği numaradır.</td></tr><tr><td>MaskedIdentityNumber</td><td>string</td><td>Kullanıcının kimlik numarasının gizlenmiş (maskelenmiş) şekilde gösterildiği bilgidir.</td></tr><tr><td>OwnerType</td><td>string</td><td>Cüzdan sahibinin türünü belirtir (bireysel kullanıcı mı, kurumsal mı olduğunu gösterir).</td></tr><tr><td>CompanyName</td><td>string</td><td>Eğer cüzdan sahibi kurumsal ise, kayıtlı şirket adını gösterir.</td></tr><tr><td>Address</td><td>string</td><td>Cüzdan sahibinin kayıtlı açık adres bilgisidir.</td></tr><tr><td>Country</td><td>string</td><td>Cüzdan sahibinin kayıtlı olduğu ülke bilgisidir.</td></tr><tr><td>City</td><td>string</td><td>Cüzdan sahibinin kayıtlı olduğu şehir bilgisidir.</td></tr><tr><td>DateOfBirth</td><td>Date</td><td>Cüzdan sahibinin doğum tarihi bilgisidir.</td></tr><tr><td>MerchantId</td><td>int</td><td>İlgili kullanıcının ilişkilendirildiği üye iş yeri (merchant) kimlik numarasıdır.</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>Kaydın sistemde oluşturulduğu tarih ve saat bilgisidir.</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>Kaydın en son güncellendiği tarih ve saat bilgisidir.</td></tr><tr><td>Wallets</td><td>List</td><td>Kullanıcıya ait cüzdanların bilgilerini içeren liste alanıdır.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.paywall.one/cuzdan-servisleri/1.-cuzdan-sahipleri/7.-vergi-numarasi-ile-sorgula.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.