> For the complete documentation index, see [llms.txt](https://developer.paywall.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.paywall.one/cuzdan-servisleri/1.-cuzdan-sahipleri/8.-externalid-ile-sorgula.md).

# 8. ExternalId ile Sorgula

## **Cüzdan Kaydını** ExternalId ile **Sorgula** 

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

{% 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 %}

**Gerekli header ve istek parametreleri:**

<details>

<summary><strong>Parametreler ve Açıklamaları</strong></summary>

<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><tr><td>ExternalId</td><td>string</td><td>Evet</td><td>Kendi sisteminizdeki kullanıcıya ait benzersiz tanımlayıcı</td></tr></tbody></table>

</details>

**Servisten dönen parametreler şu şekildedir:**

<details>

<summary><strong>Parametreler ve açıklamaları</strong></summary>

<table><thead><tr><th>Parametre</th><th>Tip</th><th width="348.94140625">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><tr><td><mark style="color:yellow;">Value</mark> > Id</td><td>Guid</td><td>Sistemde tanımlı varlığın benzersiz kimlik numarasıdır.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > 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><mark style="color:yellow;">Value</mark> > Email</td><td>string</td><td>Kullanıcının kayıtlı e-posta adresi bilgisidir.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > PhoneNumber</td><td>string</td><td>Kullanıcının kayıtlı telefon numarası bilgisidir.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > 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><mark style="color:yellow;">Value</mark> > 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><mark style="color:yellow;">Value</mark> > OwnerType</td><td>string</td><td>Cüzdan sahibinin bireysel veya kurumsal olduğunu belirten alandır.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > CompanyName</td><td>string</td><td>Eğer cüzdan sahibi kurumsal ise, kayıtlı şirket adını gösterir.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > Address</td><td>string</td><td>Cüzdan sahibinin kayıtlı açık adres bilgisidir.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > Country</td><td>string</td><td>Cüzdan sahibinin kayıtlı olduğu ülke bilgisidir.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > City</td><td>string</td><td>Cüzdan sahibinin kayıtlı olduğu şehir bilgisidir.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > DateOfBirth</td><td>Date</td><td>Cüzdan sahibinin doğum tarihi bilgisidir.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > CreatedAt</td><td>DateTime</td><td>Kaydın sistemde oluşturulduğu tarih ve saat bilgisidir.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > UpdatedAt</td><td>DateTime</td><td>Kaydın en son güncellendiği tarih ve saat bilgisidir.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > ExternalId</td><td>string</td><td>Kendi sisteminizdeki kullanıcıya ait benzersiz tanımlayıcı</td></tr></tbody></table>

</details>

{% tabs %}
{% tab title="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",
        "ExternalId" : "HMQi07tKGyHFPzYkJddO6jyddssrmbooplb+sdAFn8"
    }
}
```

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