# 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>](https://developer.paywall.one/ortam)
{% 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>