7. Vergi Numarası ile Sorgula

Belirtilen vergi numarası üzerinden cüzdan sahibi kaydına erişmek için bu servisin gerekli parametrelerle birlikte kullanılması gerekmektedir.

Cüzdan Kaydını Vergi Numarasıyla Sorgula

GET {{WalletUrl}}/api/v1/walletowner/by/taxnumber/{taxNumber}

Not: Bu servisi çağırmadan önce, apikeypublic ve apiclientpublic parametrelerini Header kısmına eklemeniz gereklidir.

WalletAPI Adresi

Gerekli header ve istek parametreleri:

Parametreler ve Açıklamaları

Parametre	Tip	Zorunlu	Açıklama
apikeypublic	string	Evet	API servislerine yapılan isteklerde kimlik doğrulaması için kullanılan genel anahtar bilgisidir.
apiclientpublic	string	Evet	API çağrısının hangi istemciden geldiğini belirtmek için kullanılan genel istemci anahtarıdır.
TaxNumber	string	Evet	Aramak istediğiniz cüzdan sahibinin vergi numarası bilgisi

Servisten dönen parametreler şu şekildedir:

Parametreler ve açıklamaları

Parametre	Tip	Açıklama
IsFailure	bool	Yapılan API çağrısının başarısız olup olmadığını belirten değerdir. (true/false)
IsSuccess	bool	Yapılan API çağrısının başarılı olup olmadığını belirten değerdir. (true/false)
Errors	Array	Servis çağrısı sırasında oluşan hata mesajlarını ve detaylarını içeren alandır.
Value	Array<Items>	Başarılı API çağrısında dönen asıl veri kümesini temsil eder.
Value > Id	Guid	Sistemde tanımlı varlığın benzersiz kimlik numarasıdır.
Value > MaskedFullname	string	Kullanıcının tam adının gizlenmiş (maskelenmiş) haliyle gösterildiği bilgidir.
Value > Email	string	Kullanıcının kayıtlı e-posta adresi bilgisidir.
Value > PhoneNumber	string	Kullanıcının kayıtlı telefon numarası bilgisidir.
Value > MaskedTaxNumber	string	Kullanıcının vergi numarasının gizlenmiş (maskelenmiş) şekilde gösterildiği numaradır.
Value > MaskedIdentityNumber	string	Kullanıcının kimlik numarasının gizlenmiş (maskelenmiş) şekilde gösterildiği bilgidir.
Value > OwnerType	string	Cüzdan sahibinin bireysel veya kurumsal olduğunu belirten alandır.
Value > CompanyName	string	Eğer cüzdan sahibi kurumsal ise, kayıtlı şirket adını gösterir.
Value > Address	string	Cüzdan sahibinin kayıtlı açık adres bilgisidir.
Value > Country	string	Cüzdan sahibinin kayıtlı olduğu ülke bilgisidir.
Value > City	string	Cüzdan sahibinin kayıtlı olduğu şehir bilgisidir.
Value > DateOfBirth	Date	Cüzdan sahibinin doğum tarihi bilgisidir.
Value > CreatedAt	DateTime	Kaydın sistemde oluşturulduğu tarih ve saat bilgisidir.
Value > UpdatedAt	DateTime	Kaydın en son güncellendiği tarih ve saat bilgisidir.
Value > ExternalId	string	Kendi sisteminizdeki kullanıcıya ait benzersiz tanımlayıcı

JSON

{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "0a949877-0ea0-48c3-9c92-41c9e33c461d",
        "MaskedFullname": "E**s S****n",
        "Email": "[e-mail]",
        "PhoneNumber": "[phone]",
        "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",
        "ExternalId" : "HMQi07tKGyHFPzYkJddO6jyddssrmbooplb+sdAFn8"
    }
}