> 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/2.-cuzdan/17.-bakiye-sorgula-alias.md).

# 17. Bakiye Sorgula (Alias)

## Cüzdan 'Alias' ile Bakiye Sorgula

<mark style="color:green;">`GET`</mark>`{{WalletUrl}}/api/v1/wallet/balance/by/alias/`<mark style="color:$warning;">`{alias}`</mark>&#x20;

{% hint style="info" %}
Not: Bu servisin kullanılabilmesi için **apikeypublic** ve **apiclientpublic** parametrelerinin Header alanına eklenmiş olması zorunludur.

\
[<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 erişimi için kullanılan genel anahtar bilgisidir.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Evet</td><td>API'ye bağlanan istemcinin kimliğini tanımlayan bilgidir.</td></tr></tbody></table>

</details>

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

<details>

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

<table><thead><tr><th width="211.05859375">Parametre</th><th width="162.38671875">Tip</th><th width="348.94140625">Açıklama</th></tr></thead><tbody><tr><td>IsFailure</td><td>bool</td><td>İşlemin başarısız olup olmadığını belirtir.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>İşlemin başarılı olup olmadığını belirtir.</td></tr><tr><td>Errors</td><td>Array</td><td>İşlem sırasında oluşan hata bilgilerini listeler.</td></tr><tr><td>Value</td><td>Array&#x3C;Items></td><td>İşlem sonucu dönen veri listesidir.</td></tr><tr><td>Id</td><td>Guid</td><td>Cüzdanın benzersiz kimlik numarasıdır.</td></tr><tr><td>Name</td><td>String</td><td>Cüzdan sahibinin ad bilgisidir.</td></tr><tr><td>Alias</td><td>String</td><td>Cüzdan için tanımlanan alternatif ad bilgisidir.</td></tr><tr><td>WalletBalance</td><td>Decimal</td><td>Cüzdandaki toplam bakiyeyi döner.<br><br><mark style="color:red;"><strong>*</strong> GiftBalance içermez</mark></td></tr><tr><td>GiftBalances</td><td>List</td><td>Cüzdana tanımlanmış hediye bakiyelerin listesini dönmektedir</td></tr><tr><td><mark style="color:yellow;">GiftBalances</mark> > Id</td><td>Guid</td><td>Hediye bakiye kaydının benzersiz tanımlayıcısı.</td></tr><tr><td><mark style="color:yellow;">GiftBalances</mark> > Amount</td><td>Decimal</td><td>Hediye bakiyenin tanımlandığı andaki toplam tutarı.</td></tr><tr><td><mark style="color:yellow;">GiftBalances</mark> > RemainingAmount</td><td>Decimal</td><td>Hediye bakiyenin kalan kullanılabilir tutarı.</td></tr><tr><td><mark style="color:yellow;">GiftBalances</mark> > ExpirationDate</td><td>DateTime</td><td>Hediye bakiyenin son kullanma tarihi. <code>null</code> ise süresizdir.</td></tr><tr><td><mark style="color:yellow;">GiftBalances</mark> > IsUnlimited</td><td>bool</td><td><code>ExpirationDate</code> değeri <code>null</code> ise <code>true</code> döner, hediye bakiyenin süresiz olduğunu belirtir.</td></tr><tr><td><mark style="color:yellow;">GiftBalances</mark> > Description</td><td>String</td><td>Hediye bakiyeye ait açıklama veya not.</td></tr><tr><td><mark style="color:yellow;">GiftBalances</mark> > CreatedAt</td><td>DateTime</td><td>Hediye bakiye kaydının oluşturulma tarihi ve saati (UTC).</td></tr><tr><td>TotalGiftBalance</td><td>Decimal</td><td>Cüzdandaki toplam hediye bakiyesini döner</td></tr><tr><td>BlockedBalance</td><td>Decimal</td><td>Kullanılamayan (bloke edilmiş) bakiyeyi döner</td></tr><tr><td>TotalBalance</td><td>Decimal</td><td>Cüzdan içerisindeki toplam bakiye<br><br><mark style="color:green;">Formül:</mark> <mark style="color:blue;">WalletBalance</mark> + <mark style="color:purple;">TotalGiftBalance</mark></td></tr><tr><td>AvailableBalance</td><td>Decimal</td><td>Cüzdan içerisindeki kullanılabilir bakiye. Bu bakiye hediye bakiyeleri de kapsamaktadır. Ek olarak bloklu bakiye varsa kullanılabilir bakiye miktarı bloklu bakiye kadar düşmektedir<br><br><mark style="color:green;">Formül:</mark> (<mark style="color:blue;">WalletBalance</mark> + <mark style="color:purple;">TotalGiftBalance</mark>) - <mark style="color:red;">BlockedBalance</mark></td></tr><tr><td>AllowOverdraft</td><td>bool</td><td>Cüzdanın eksi bakiyeye düşmesine izin verilip verilmediğini belirtir. <code>true</code> ise bakiye sıfırın altına inebilir.</td></tr><tr><td>OverdraftLimit</td><td>Decimal</td><td>Cüzdanın düşebileceği maksimum eksi bakiye limitini belirtir. <code>AllowOverdraft = true</code> olduğunda geçerlidir. <code>null</code> ise limit tanımlanmamış demektir.</td></tr></tbody></table>

</details>

{% tabs %}
{% tab title="JSON" %}
{% code lineNumbers="true" %}

```json
{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "7883fb19-2359-4a9b-b917-f08a259898ed",
        "Name": "External Test Wallet",
        "Alias": "2816220769",
        "WalletBalance": 0.80,
        "GiftBalances": [
            {
                "Id": "aa230ce5-127d-44a0-b480-7f9c4a24a9fd",
                "Amount": 10.00,
                "RemainingAmount": 7.50,
                "ExpirationDate": "2025-12-31T23:59:59Z",
                "IsUnlimited": false,
                "Description": "Hoşgeldin bonusu",
                "CreatedAt": "2025-08-20T10:09:37.007Z"
            }
        ],
        "TotalGiftBalance": 7.50,
        "BlockedBalance": 0,
        "TotalBalance": 8.30,
        "AvailableBalance": 8.30,
        "AllowOverdraft": false,
        "OverdraftLimit": null
    }
}
```

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