> 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/6.-hediye-bakiye/5.-sorgula-alias.md).

# 5. Sorgula (Alias)

## Hediye Bakiye 'Alias' ile **Kayıt Sorgulama**

<mark style="color:green;">`GET`</mark>`{{WalletUrl}}/api/v1/balance/gift/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şiminde doğrulama için kullanılan genel anahtar bilgisidir.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Evet</td><td>İsteğin hangi istemciden geldiğini gösteren genel istemci anahtarıdır.</td></tr><tr><td>Alias</td><td>string</td><td>Evet</td><td>Hediye bakiyeleri listelenecek cüzdanın alias'ı</td></tr><tr><td>IncludeExpired</td><td>bool</td><td>Hayır</td><td>Süresi dolmuş hediye bakiyelerin listeye dahil edilip edilmeyeceğini belirtir. Varsayılan: <code>false</code></td></tr><tr><td>IncludeFullyUsed</td><td>bool</td><td>Hayır</td><td>Tamamen kullanılmış hediye bakiyelerin listeye dahil edilip edilmeyeceğini belirtir. <code>null</code> ise filtre uygulanmaz</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="234.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>İşlem başarısızsa false, değilse true döner.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>İşlem başarılıysa true, aksi halde false döner.</td></tr><tr><td>Errors</td><td>Array</td><td>Oluşan hata detaylarını içeren dizi yapısıdır.</td></tr><tr><td>TotalAmount</td><td>int</td><td>Cüzdandaki tüm bakiye kayıtlarının başlangıç tutarlarının toplamıdır. Kullanılmış veya kalan tutardan bağımsız olarak tanımlanan toplam bakiyeyi ifade eder.</td></tr><tr><td>TotalRemainingAmount</td><td>int</td><td>Cüzdandaki tüm bakiye kayıtlarında henüz kullanılmamış (harcanabilir) tutarların toplamıdır.</td></tr><tr><td>Items</td><td>Array</td><td>Sonuç verilerini içeren öğe listesini barındırır.</td></tr><tr><td>Id</td><td>Guid</td><td>Sistemde bu varlığı benzersiz şekilde tanımlayan kimliktir.</td></tr><tr><td>WalletId</td><td>Guid</td><td>Kaydın bağlı olduğu cüzdanın eşsiz ID bilgisidir.</td></tr><tr><td>Amount</td><td>string</td><td>Tanımlanan toplam bakiye bilgisini metinsel olarak tutar.</td></tr><tr><td>RemainingAmount</td><td>decimal</td><td>Mevcut bakiye içerisinden harcanmamış kalan kısmı ifade eder.</td></tr><tr><td>ExpirationDate</td><td>decimal</td><td>Bakiyenin sona ereceği tarihi timestamp formatında temsil eder.</td></tr><tr><td>IsUnlimited</td><td>string</td><td>Hediye bakiyenin süresiz olup olmadığını belirtir. <code>ExpirationDate</code> değeri <code>null</code> ise <code>true</code> döner ve hediye bakiyenin son kullanma tarihi olmadığını ifade eder.</td></tr><tr><td>Description</td><td>string</td><td>Bakiye veya işlemin açıklamasıdır, kullanıcıya bilgi verir.</td></tr><tr><td>IsUsed</td><td>bool</td><td>Hediye bakiye kullanıldı mı?</td></tr><tr><td>IsFullyUsed</td><td>bool</td><td>Hediye bakiye tamamen kullanıldı mı?</td></tr><tr><td>IsPartiallyUsed</td><td>bool</td><td>Hediye bakiye kısmi kullanıldı mı?</td></tr><tr><td>LastTransactionId</td><td>Guid</td><td>Bu bakiyeyi kullanan son işlemin kimliğidir.</td></tr><tr><td>CreatedAt</td><td>Guid</td><td>Hediye bakiyenin oluşturulma tarihi</td></tr><tr><td>UpdatedAt</td><td>int</td><td>Hediye bakiyenin güncellenme tarihi</td></tr></tbody></table>

</details>

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

```json
{
    "IsSuccess": true,
    "IsFailure": false,
    "totalAmount": 200.00,
    "totalRemainingAmount": 200.00,
    "Items": [
        {
            "Id": "29bddd16-16d1-4b16-bca9-906f9ef80725",
            "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
            "Amount": 100.00,
            "RemainingAmount": 100.00,
            "ExpirationDate": "2025-11-10T21:00:00Z",
            "IsUnlimited": false,
            "Description": "External Gift Balance",
            "IsUsed": false,
            "IsFullyUsed": false,
            "IsPartiallyUsed": false,
            "LastTransactionId": null,
            "CreatedAt": "2025-08-20T14:32:16.468416Z",
            "UpdatedAt": null
        },
        {
            "Id": "47c4ec69-58d2-415c-841e-c1144542181b",
            "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
            "Amount": 100.00,
            "RemainingAmount": 100.00,
            "ExpirationDate": null,
            "IsUnlimited": true,
            "Description": "External Gift Balance",
            "IsUsed": false,
            "IsFullyUsed": false,
            "IsPartiallyUsed": false,
            "LastTransactionId": null,
            "CreatedAt": "2025-08-20T14:33:15.741943Z",
            "UpdatedAt": null
        }
    ]
}
```

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